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If you are using a QL in any shape or form or with 
any accessory (thus including the new QXL 
68040, Gold Card, Trump Card, ST/QL, Thor, PC 
CONQUEROR, Minerva, TURBO, and even the 
humble unexpanded microdrive-only QL), you 
really should be using LIGHTNING SPECIAL 
EDITION. If not, you are very severely and 
unnecessarily (our program is quite inexpensive) 
slugging your system's performance. The superb 
LIGHTNING SPECIAL EDITION will both 
automatically and very significantly accelerate 
almost every aspect of QL operation - whatever it 
is you use the QL for. "More than 10x is 
achievable and 2x-4x is typical” 
(quote from page 24 of review in April '90 QL 
World). The speedup ratio is independent of the 
system. However fast or slow your hardware, 
LIGHTNING SPECIAL EDITION _ will 
accelerate it much further. All recent versions of 
our software are carefully optimised for 16/32 bit 
processors, without compromising 8 bit working. 
The program has not got any adverse side effects 
at all, and it fixes QL anomalies. Installing it is a 
fast, once-only operation that takes two or three 
minutes and which assumes & requires absolutely 
no knowledge of programming or of anything even 
remotely technical about the QL: you are simply 
asked whether you wish to speed up text, maths 
and graphics individually, or everything. Unless 
you have a very good reason, opt for everything! 
Then LIGHTNING SPECIAL EDITION copies 
itself onto your boot-up disks, instantly modifying 
their BOOT files. Now every time you start up, full 
throughput acceleration is automatically invoked 
and everything goes much smoother and faster. In 
case you think that this is too good to be true, we 
quote verbatim the concluding para of the Sinclair 
QL World review: "J could not fault 
LIGHTNING SPECIAL EDITION on 
anything. It is a clear winner and 
a best buy at £49.95”. The program 
includes a bundle of accessories (change fonts 
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etc. in Quill etc., smooth scrolling and much more) 
and tweaks (vary maths and/or graphics precision, 
a null device and much more). Stop reading the 
manual where we tell you to - at around page four 
- if simple use is all that you want. The program 
also includes 84 excellent small fonts for use with 


both PERFECTION SPECIAL EDITION and 
PROFESSIONAL PUBLISHER: a real bonus! 


LIGHTNING SPECIAL EDITION includes 
both a ROM (for plugging in at the back of your QL 
- No screwdriver needed) and a disk. As some QL 
hardware (QXL; Gold Card for speed reasons) is 
not ROM-friendly, or you might have something 
already plugged in (ICE, TK2 if not already on 
your disk interface), you can get a version of the 
program minus the ROM for just £39.98: this is 


the GOLD CARD VERSION. If you have two 
QLs, say one of them a QXL / Gold Card and one 


"ordinary", you should go for the full LIGHTNING 


SPECIAL EDITION. as you can use the ROM 
on the second machine. Extra ROMs cost £10 if 
ordered at the same time as the program, else £15. 

Q1) What programs benefit from LIGHTNING SPECIAL 
EDITION (LNGSE)? A) All, Including emulators. Perhaps 
PERFECTION SE benefits most. Q2) Why didn't you build 
it Into all your programs? A) It would be very Inefficient to 
do so because of multitasking. Also, LNGSE benefits all 
programs (even Quill etc.), not just our ones. Q3) Does 
the QL "know’ it Is running LNGSE? A) No. And it Isn't 
“running” LNGSE either. In its first and only second of life 
LNGSE pages out, using a door deliberately left open by 
the QL's forward-thinking designer, large chunks of QDOS 
(AH, JM, JS, MG and all Minerva operating system 
variants) and replaces them with our fine-tuned supercode. 
Q4) Is It a compller? A) No - TURBO Is. LNGSE greatly 
Improves the performance of TURBO'd programs too! Q5) 
Why Is LNGSE so cheap? (happy users ask this) A) The 
truth is, we know that once you have experienced 
LIGHTNING SPECIAL EDITION, you won't abandon 
your QL. As THE QL software publisher, that is rather good 
news for us. Q6) Give me one more reason for buying it. 
A) Look at our SPECIAL DEALS, and think. Even before 
any seasonal discount, LNGSE Gold Card would add a 
mere £30 to the price of PERFECTION PLUS SPECIAL 
EDITION, for example. SPECIAL DEALS allow you to get 
programs for free, even to get us to pay you to buy them... 
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PERFECTION SPECIAL EDITION 


AN EXCITING NEW DEVELOPMENT 


In the case of many word-processing objectives, the best way to 
implement them is pretty clear. There are some areas, however, 
where individual tastes and preferences can differ very widely. 
One such area is the reformatting of text - the adjustment of 
previously entered text to conform to margin, indentation, 
justification and pagination settings after you go back (or 
forward!) to it and make alterations, either by hand (by typing 
and/or deleting) or by using individual or global search and 
replace. When new text is being entered at the foot of the 
document or at the end of the current paragraph, all word- 
processors behave virtually identically, obeying the current 
settings - it is in the matter of amending existing text (inserting, 
changing or deleting) where conflicting philosophies apply. Text- 
ange differ in their treatment of this: Editor, Wordperfect, 
text87, Quill, AmiPro & Word all behave differently. 


Editor, Spy, most versions of Wordstar, and all technical editors 
leave all reformatting to you. While at first this may seem harsh, 
this manual mode gives you a lot of control, makes the handling of 
tables and other technical applications better (do you really want 
to reformat that BASIC program into a single paragraph?!?), and 
is easy on the eye. But you must remember to reformat as the 
program won't, and this may be an annoyance. If you move away 
and forget to clean up, your printout will probably be incorrect. 


Wordperfect will auto-reformat, but generally only when you 
move the cursor from the line containing the change. Changes you 
make while your cursor is within the line will only cause the line 
to contract or expand up to the margin. This too is easy on the eye, 
but there is the drawback that the overall picture of the page may 
be inaccurate while you are inserting or amending text, and that 
when you move the cursor away (and hence trigger the auto- 
reformat), you may not notice any undesirable effects caused (e.g. 
widows, orphans, inappropriately positioned page or line breaks). 


QL Quill auto-reformats, but because of its slowness it uses a 
trick: often when you start inserting within the middle of a 
paragraph, Quill splits the para in two and creates temporary blank 
lines to separate the parts. This means Quill does not need to 
reformat until you have finished amending. What you type appears 
at the end of the first part of the paragraph. This has the advantage 
and disadvantages of the Wordperfect method, but additionally the 
split can be a bit disconcerting and the screen display can be 
grossly wrong during the editing. Also, we know of a bug that 
causes a line to be shown twice on the Quill screen while it is only 
really present once: you will regret it if you delete the apparent 
duplicate as an unduplicated line will get deleted without warning. 


Word (a fine PC Windows program) auto-reformats in situ, in real 
time, as-you-type. But if you have a long complex para and you 
are editing near the top of it, you may notice the time taken for the 
reformat even on a 486/66MHz (QL users should note that this is 
>20 times faster than a Gold Card i.e. about the speed we expect 
from a fully tweaked QXL). Also, cursor movement will appear to 
some as a bit erratic (which is hard on the eye) especially if right 
justification is on or if the on-screen fonts are proportional. It can 


Version 5! 


(giving slightly delayed updating of lower lines of text, like 
AmiPro, but also - and unlike AmiPro - giving you, the user, full 
control over how long the delay is). No other w.p. is this able. 


On User-delay the user is free to set any delay from 0.1 seconds to 
99.9 seconds in 0.1 second steps. About 1-2 seconds is best for 
slow typists, and 1.5 seconds is thus the default. This means that 
you are not hassled by continuing screen changes on lines below 
the one you are editing and concentrating upon, or shufflings 
around on the current line caused by right justification etc. So the 
Word disadvantage (much more noticeable on slower hardware) is 
avoided, without recourse to the Quill temporary blank line 
nuisance. When you pause in your typing for longer than the set 
delay, PERFECTION SPECIAL EDITION (SE) automatically tidies up, 
without you having to do anything (getting around the 
Wordperfect and Quill drawback of making you mentally adjust 
for the screen remaining occasionally out-of-sync with reality). 


If you are a reasonably fast typist, you can experiment with shorter 
delays (say 0.5 seconds). If you are a speed demon, set the delay to 
0.1 seconds and see if you can ever manage to "get ahead" of the 
program! Settings of under 0.3 seconds are indistinguishable from 
Instant’, when reformatting always keeps pace. 


On the User-delay setting PERFECTION SE will, as does Quill and 
Wordperfect, auto-reformat instantly (no matter how long a delay 
you have set) if you either navigate off the line or invoke any 
menu or direct command (including Save, Export etc.). This 
means that you are never left with the document "wrong". 


There are many other improvements in this release of PERFECTION SE. 
One in a similar area is with SHIFT/CAPS, the one (out of five) manual 
reformatting commands that allowed reformatting of a para from the 
current line onwards without affecting previous lines. SHIFT/CAPS will 
now additionally obey the indent margin (which matters if the cursor is on 
the first line of the para) and, more significantly, it will leave the cursor 
position unaltered within the text (previously, it used to move the cursor to 
the start of the next para). Other reformatting commands are unaltered, so 
you can still step through paras reformatting easily. 


PERFECTION SE v5 costs £99.95, or £139.95 in PLUS SE incarnation (i.e. with spellchecker, dictionaries 
& maintenance programs), less discounts that can total 40%. There is no special upgrade price to v5 
for existing SE owners - only DP's usual reasonable £10 update charge (but as an offer to JQIR 
readers, open for four weeks from the date of publication of this issue, existing SE or PLUS SE owners 
can get the upgrade totally free provided they order other DP programs of total value (after all 
discounts) exceeding £25). To upgrade from the STANDARD version of PERFECTION costs, as with 
all upgrades, the difference in price plus just £10, ie. £50. The user should not retum any 
documentation, just the one master disk. Remember special deal prices, which give discounts of up to 
25% if more than one program is purchased (or upgraded) at the same time (do you have 
LIGHTNING SE?). To get the very best out of PERFECTION SE, use it with PROFESSIONAL 
PUBLISHER (and perhaps with attendant TOOLBOXes and FONT ENLARGER), when you can 
output text to any number of shapes of any desired complexity (not just boring columns!) throughout 
maintaining pixel proportional spacing and having thousands of fully WYSIWYG fonts to choose 


A\ll trademarks are acknowledged as belonging to their respective owners. 


from, whatever your printer... 


OTHER SPECIAL PROGRAMS FROM DP 


also be quite distracting to keep seeing the ripple effect of changes 
as text on lower lines is reformatted. AmiPro is somewhat better in 
this respect as there is a small delay (almost a second) before 
AmiPro refreshes lower lines on the screen: easier on the eye. 


The new release of PERFECTION SPECIAL EDITION, version 5, gives 
the user the best of all worlds, by combining the best of all the 
above methods and avoiding all the drawbacks. The user is given 
the opportunity both to pre-configure and to adjust at will from 
inside the program, the desired auto-reformatting behaviour. The 
options are to either select Never (giving Editor-like action for 
technical users: this is what all previous versions did, where you 
had to press a key to get the para to reformat after re-editing it), 
Instant (giving in-situ real-time automatic reformatting as-you- 
type, as does Word) or User-delay, the most flexible setting of all 


PC CONQUEROR GOLD SPECIAL EDITION The rave review on pages 16 to 19 of 
March 1993 QL World really says it all: "an excellent product", "much faster, more compatible and capable 
than its predecessor". There are many extra features too. You can also get DR-DOS v6.0 (with Netware Lite 
free), which is the best DOS of all. And if you are buying or have bought this DOS from us, you can buy 
preconfigured DOS pseudo hard disks (on ED diskette) for £15 each (specify if you want compressed i.e. 
6Mb capacity, or 3Mb: or have one of each for £25). 

QMATHS MATHEMATICAL SYSTEM PART TWO A superb companion to 


QMATHS, with maths, stats, Abacus stuff, expression evaluation, terrain plotting, the fastest Mandelbrot 
routines and much more. Note the special price for 1+2. 

TRANSFER UTILITY SPECIAL EDITION Copies and transfers, with optional sorting, 
case-changing, formatting, statistics and more. 

QUICKLASER Superb print output from PRO PUBLISHER to HP Deskjets, Laserjets (the latter 
with 1Mb of RAM or more) and all compatibles. QUICKLASER costs just £19.95 all inclusive. 
LIGHTNING SPECIAL EDITION GOLD CARD VERSION optimal speed from 
higher specified QLs - GOLD CARD, QXL, ST/QL, Thor XVI etc. Free upgrade from standard version if 
you return ROM + disk and are ordering something else at the same time, else £10 charge. 


PERFECTION 


PERFECTION PLUS 


Perfection Is the finest word processor available for any 
computer. We have received dozens of letters from 
happy users saying just this... and all of these letters 
were unsolicited. "Superb“ was used most often. 


Perfection manages to achieve all the sophistication of 
the most complex PC word processors while still using a 
user Interface as friendly as Quill's. Perfection has a dual 
system of user control: menus while you are familiarising 
yourself with the program, and direct commands for the 
time when you feel ready for more adventurous things. 
The two systems can be used interchangeably and even 
simultaneously. Even more exciting — both systems are 
Iterative. In case you don't understand what this means, 
let us give you an example: suppose you wished to move 
a block of text using the menus. You would choose Block 
Move (yes, it is right in the first menu) and the screen 
would then tell you to move your cursor to the start of 
the block. On most word processors you would have to 
navigate manually to this position: indeed, on many of 
them (Quill included) only a subset of the normal 
navigation commands would be available. On Perfection, 
not only can you use all the manual navigation 
commands (viz all 28 permutations of CTRL, ALT, SHIFT 
and the arrow keys!) but in addition you can use direct 
commands like GoTo Line or Page or any of eight 
markers. Even more amazingly, you can use Search 
(either as a direct command or from the menus) even 
though you are already 'within' a menu option. 


Perfection has about 200 commands, but the layout of 
menus and the choice of keys for the direct commands 
makes It very easy to master. Though a 100+ page 
manual is provided (with all the important bits right at 
the front), you should only need to consult it for 
specialised operations like macros. 


Even If speed is not particularly important to you, we 
assure you that Perfection's lightning performance will 
enable you to use the word processor in sensible ways 
that you would not have dreamed possible before. For 
example, scrolling 100 pages or so is accomplished so 
quickly using the normal navigation commands that you 
do not need to bother using a menu option to do the 
move. Spelichecking, assuming you have Perfection Plus, 
Is accomplished virtually instantly: to spellcheck this 
whole ad (all the pages) would take under 1.5 seconds... 
Searching (you can switch case sensitivity, as well as 
equivalences between tabs, soft spaces and hard spaces) 
is at the rate of about 100 A4 pages per second. 


Moving from one word processor to another is usually 
very traumatic. With Perfection, this will not be the case. 
Not only can Perfection read In Quill _doc and _exp files 
directly (you do not even need to tell it they are Quill 
files!) but it can make direct and immediate use of your 
existing Quill printer driver. File re-export Is also possible. 


Perfection Is truly WYSIWYG: this means that bold 
appears bold on screen, Italics appear as italics, 
underlined as underlined, and so on. Of course, your 
printer may have functions we do not know about 
(upside down?). To deal with these, Perfection provides a 
number of on-screen shaded strips: these can be 
attached to any printer function you wish, and will not 
upset justification as a translate would. Of course, 
translates are provided as welll 


A variety of statistics on the document being processed 
are available: some of them are on view all the time, the 
rest can be toggled to instantly. Not only is there a word 
count, but also page, line, character and special 
character (like Superscript Off) counts. There are also a 
dozen status Indicators, letting you know whether you 
are In Insert or Overwrite mode, whether a block Is 
defined, whether Interactive spellchecking Is enabled 
etc. Current line (from top as well as within page) and 
column positions and character codes are also available. 


A terrific feature of Perfection is the dual screen mode. 
You can view one part of the document while editing 
another, The sizes of the two windows are themselves 
adjustable, both In real-time or via the configurator. We 
should devote more space to the configurator: however, 
it must suffice to say that everything that could be 
dynamically set within Perfection may also be preset 
with the configurator. The configurator can, for 
example, allow you to select any of 256 colours for any 
of a dozen parameters (like paper colour, border colour, 
status window ink and paper colour etc). 


Perfection is fully multitasking without need for any 
external accessory: however, If you already use QPAC or 
Taskmaster or similar and are happy, you may go on 
doing so. 


There Is absolutely no way that we can prepare you for 
the quality 'feel' of Perfection. We have a great deal of 
experience using PC word processors costing many 
hundreds of pounds: with absolutely no exception, 
Perfection is far easier to use and master. 


So if you thought Perfection was unattainable, you have 
a very pleasant surprise coming to youl 


LIGHTNING SPECIAL EDITION 
LIGHTNING 


These programs accelerate QL operation by up to 10x (2x 
-4x Is typical) without having any adverse effect 
whatsoever on compatibility or anything else. Lightning 
SE Is typically 40% faster than the standard version. This 
acceleration Is totally independent of, and in addition to, 
any speed-up obtained by hardware means. So if you 
have Gold Card, your need for Lightning SE is just the 
same as if you had only an unexpanded QL - Lightning 
SE will accelerate both by the same ratio. 


The Lightning programs achieve their acceleration by 
automatically paging out sections of the QL's operating 
system and replacing these with optimal, concise code 
written by us. 


Lightning installation is a completely automatic and one- 
off: no knowledge of computing or programming is 
required. Once installed, Lightning can be completely 
forgotten about - you will soon get used to the superb 
speed! Knob twiddlers are catered for too. 


Lightning technology is not built in to any of our other 
programs. Perfection users (as well as users of all other 
QL software) should therefore use Lightning all the time. 


In summary: if you do not have Lightning, you are 
wrong. Buy this one ARST OF ALL! 


PROFESSIONAL PUBLISHER 


The Professional in Professional Publisher is 
Professional Publisher supplied with a generous 
refers to the quality of selection of fonts of vari- 
output from that program, ous sizes, as well as clip 
and is not meant to sug- 
gest any complexity of op- 


eration. Few programs are 
as easy to use as this 


users will 
be able qo Oo 
to do , 
with- O 

out using 
a manual! 
Professional Publisher Is by 
far the best DTP program 
for the QL. It Is fully com- 
patible with Perfection, 
Editor, Quill, Eye-Q & the 
ASCII editors. It allows you 
to both create and import 
both text and graphics. 
Text can be ‘poured’ into 
boxes of any shape , size 
and number, automatically 
maintaining Justification 
and hyphenation settings. 
So flowing text around 
graphics Is a doddle. 


CN 
one: > oe 
99% of pouer® 


Justification 
is by pixel, not by 
character. This gives a 
much smoother effect. 
tt Is pointless for us to try 
to list all of Professional 
Publisher's features — we 
would end up filling half 
the magazine! We will 
concentrate on just a few 
‘points': Professional 
Publisher Is extremely pre- 
cise, performing all its 
computations accurate to 
a small fraction of a mil- 
limetre. All its features can 
be preset by you using Its 
configurator, ruling out 
the need for repetitive key 
strokes. 
The program |s extraordi- 
narily versatile while re- 
maining Intuitive in its 
user interface. Buy it! 


PROFESSIONAL PUBLISHER 


TOOLBOXES 


Toolbox | Is an excellent collection of high definition 
fonts, clip art and utility programs for Professional 
Publisher. While the fonts supplied with Professional 
Publisher are excellent, many users will feel the need for 
a wider range of typefaces and styles. 


Toolbox Il starts where Toolbox | leaves off, providing an 
even better — and different — font collection. 


The two Toolboxes complement each other and are 
available together at a special price. 


FONT ENLARGER 
GRAFIX 


Font Enlarger does exactly what you would expect it to 
from its name. While Professional Publisher Is also 
capable of enlarging fonts, it does them ‘on the fly’ and 
consequently Is not able to remove the Jaggedness 
caused by magnification. Font Enlarger is much cleverer, 
and enhances detail without any step effect. 


While the built-in printer driver for Professional 
Publisher is excellent with 9-pin printers, It Is not optimal 
with 24-pin or laser printers. Grafix Is. 


40 
ADIGITAL PRECISION:10 
i mg 


EYE-Q 
ULTRAPRINT 


Eye-Q Is the finest graphics program for the QL. While 
there may be other graphics programs with a few more 
features, no other program comes anywhere close to 
Eye-Q in sheer enjoyability. Eye-Q develops a pleasurable 
tactile relationship with you, and makes you feel like an 
artist (even if you aren't). Eye-Q graphics can be read In 
by Professional Publisher, and the latter's pages can be 
exported to Eye-Q (using Toolbox I). Everything in Eye-Q 
is menu-driven and there is context-sensitive help. 


While Eye-Q has Its own printer driver, Ultraprint allows 
you 22 distinct styles/sizes of printer output. The 
reasoning Is that the scale of gradation suitable for 
pictures is probably unsuitable for text or line drawings. 


PC CONQUEROR 
SOLUTION 


PC Conqueror makes your QL Into a PC-compatible 
machine, automatically. It does this by software means 
only, so there are no screws to undo or wires to fiddle 
with. Your QL stays a QL too. 


Why, might you ask, should you wish to make your QL 
into a PC-compatible? The reason is simple: you may wish 
to run the same programs at home as you do at work. 
Alternatively, you may wish to tap Into the vast 
storehouse of PC software of every type and description 
you could imagine. 


Using PC Conqueror could not be easier. Just boot up your 
machine with the PC Conqueror disk in floppy 1 and 
within 10 seconds your QL will be transformed into a PC 
that is just waiting to be switched on. From this point on 
you will do exactly the same as you would if you were 
running a ‘real’ PC - this means putting a DOS disk (any 
version) into one of your drives and pressing a key. If you 
do not already have legal access to a copy of DOS, we can 
provide you with one at reasonable cost (see our price 
list). 


PC Conqueror runs as fast as it is possible for a PC 
emulator to run: we have used all our ‘skills to make it 
work quickly. Of course, you can make the emulation 
must faster by using Gold Card and Lightning SE. With 
this combination, you should get speed noticeably better 
than that of a PC XT... 


PC Conqueror allows you to fine-tune the operating 
environment of the PC in order to improve performance. 
If you get a hard disk or other high capacity floppy 
system, you can utilise part or all of it as a PC hard disk. 


PC Conqueror occupies under 80K and leaves 667K free 
for DOS when run on a Trump Card, This is more than you 
will get on a ‘real’ PC. 


Solution does what Conqueror does but Is about half as 
fast and is not quite as compatible. 


SPELLCHECKER 
MEGA DICTIONARY 


Spelichecke” is what makes Perfection into Perfection 
Plus. We have made It available as a separate item for two 
reasons: (a) to allow Perfection owners to add It later 
(b) to allow users of other word processors to benefit 
from the very best In spellchecking technology. 


Spelichecker Is supplied complete with three dictionaries 
of differing sizes as well as a system for building, 
reviewing and maintaining user dictionaries. 


Spelichecker's ultimate accessory Is the Mega Dictionary, 
which gives the user a vocabulary of over 350,000 words! 


3D PRECISION CAD SYSTEM 


This program allows you to manipulate shapes and 
figures In 2D and 3D at a speed that will leave you 
breathless. Irrespective of whether your interest is in CAD, 
In animation or in just having fun, this program should 
not be missed. You can output to plotters directly from It, 
or alternatively create graphics screens to be manipulated 
and output by Eye-Q, Ultraprint or Professional Publisher. 


SUPER SPRITE GENERATOR 


SSG moves things about the screen very fast and very 
smoothly, without flicker. Sprites can have up to 16 frames. 


MEDIA MANAGER SPECIAL EDITION 
MEDIA MANAGER 


Media Manager Special Edition (MMSE) Is a program to 
be used both when things have gone wrong as well as 
when things are perfectly OK. It allows for automatic, 
seml-automatic and manual correction of a huge variety 
of disk and tape problems. It allows you to explore disks 
and tapes to your heart's content, producing all sorts of 
different diagnostic reports. MMSE Is very simple to 
operate, being menu-driven and assuming no degree of 
computer knowledge whatsoever. 


MMSE also allows you to tidy, catalogue, sort and order 
your disks and cartridges. 


The standard Media Manager is both less powerful and 
less user-friendly, but manages to work on an 
unexpanded QL. 


Both programs allow for data transfer between PC and 
QL. With MMSE, this transfer Is at file and directory level, 
Is bi-directional and is completely automatic. 


SPECIAL DESKTOP PUBLISHER 
DESKTOP PUBLISHER 


These programs are quite primitive compared to 
Professional Publisher, However, if you have not 
experienced that program as yet, you will find both of 


these very competent. Both are capable of producing 
excellent results. The cheaper one has fewer features but 
Is able to run on smaller systems. 


EDITOR SPECIAL EDITION 
THE EDITOR 


With the sole exception of Perfection, this is the best 
word handling system on the QL. Editor's features 
include an unrivalled degree of programmability and the 
ability to cope with the entire 256 character ASCII set. 
The Special Edition has enhanced document-type 
facilities, Including column blocks and on-screen page 
break displays. Neither program Is suitable for 
computing novices. Until Perfection, Editor Special 
Edition would have been our ‘Desert Island Program’. 


Editor SE can do a few things that Perfection can't, so 
the Ideal combination Is to have both (they are 
compatible at file level and can multitask). If you order 
Editor SE at the same time as Perfection, you can have 
Editor SE at half price. 


PROFESSIONAL ASTROLOGER 


PROFESSIONAL ASTRONOMER 


The Astrologer program teaches you Astrology from 
scratch and enables you to automatically produce text 
narrative on personality delineation, year-to-year and 
minute-to-minute life predictions, compatibility 
interpretations and so on. Whether or not you believe in 
astrology — indeed, especially if you do not — this 
program Is one that you cannot afford to have. You can 
tailor the readouts (both in terms of quantity and what 
is said) to your own particular requirements. The amount 
of fun you can have with this program Is endless. Do not 
blame us if you start believing In astrology, though! 


Astronomer Is an extremely fast and accurate solar 
system calculator, with planetarium views, planet faces, 
eclipses, cinerama display etc.. 


TURBO BASIC COMPILER 


Turbo is the finest BASIC compiler for the QL and 
arguably the finest BASIC compiler for any computer! 


Turbo automatically converts working BASIC programs 
into optimised machine code, usually with no need for 
human intervention. The benefits of this conversion are 
vastly enhanced running speed (as well as much faster 
loading, encryption and automatic bug fixing for a variety 
of QL interpreter oddities). Typical speed-up is 40x — 100x. 


Turbo Is provided with a 200 command toolkit, adding 
many useful commands to BASIC. Most of these 
commands will be of immediate use to the programmer, 
whether he is a novice or an expert. There are commands 
to load strings and floats into RAM, and to extract them 
automatically; to search memory and to move Its contents; 
to control jobs and change their priorities, manage pipes, 
allocate and deallocate memory, to control both rubber 
and virtual arrays, to present INPUT with an editable 
default, to have random access to files and much more. 


TOOLKIT Ill 


Toolkit Ill starts where Toolkit ll stopped, adding about 
60 new commands and enhancing many existing dual 
functions. Toolkit Ill is available either on disk or on 
ROM, and works whether or not you have Toolkit Il. 


Toolkit Ill commands can, with only a couple of 
exceptions, be compiled using Turbo. 


QFLICK CARD INDEX 


All QL owners have a copy of Archive, supplied free with 
the QL. While Archive is competent, it is very hard to get 
to grips with and Is not particularly fast. QFlick presents 
a very convenient alternative — a snappy , simple-to-use, 
pointer-controlled card file database. You can move data 
between QFlick and Archive In either direction. 


QFlick Is not Itself programmable but we document Its 
data structure and give guidance on how to program it 
using Turbo. 


ARCHDEV + RTM 
DATABASE ANALYSER 
ARCHIVE TUTORIAL 
NAMES + ADDRESSES 
MAILMERGE 
DAT-APPOINT 
SEDIT 
SCREENPRINT 
RECOVER 


This suite of utilities will greatly enhance your use of the 
Archive database system. 


Archdev + RTM Is a straight replacement for Archive: It 
gives enhanced speed, greater workspace and a much 
cleaner boot-up. All your existing applications will work. 


Database Analyser provides very fast and comprehensive 
statistics about your Archive databases. 


Archive Tutorial proceeds systematically through the 
whole philosophy and grammar of Archive, providing 
you with expert and patient guidance. 


Names + addresses, Mailmerge and Dat-Appoint are 
ready-to-run, off-the-shelf Archive applications, 
providing an address database, mailmerging and 
appointment diary respectively. You now have no excuse 
not to use Archive. 


SEdit allows you to create and edit screen format files In 
Archive. Screenprint allows you to print them out. 


Recover allows you to get back lost Archive databases, 
created when you switched off the computer without 
properly exiting from Archive. 


XREF 
SUPERBASIC MONITOR 
BETTERBASIC EXPERT SYSTEM 


XRef analyses the structure of a BASIC program, 
providing detailed reports on things like variable usage, 
what calls what, dynamic call hierarchy of procedures 
and functions, and so on. 


SuperBasic monitor actually monitors and reports on the 
performance of BASIC programs as they run under the 
interpreter. 


BetterBasic analyses and automatically corrects structural 
flaws In your programs and allows you to customise 
things like indentation, number of statements per line, 
filtering out of noise words, etc. 


The three programs together provide a matchless 
diagnostic and auto-correcting facility for BASIC 
programs. 


TRANSFER UTILITY 


This program copies files at high speed between devices, 
performing translates as it goes along. Ideal for all sorts of 
applications, Including transfers from microdrive to disk. 


QMATHS SYSTEM 


This Is an Incredible mathematical compendium for the 
QL. Pride of place goes to the symbolic problem solver: 
this can solve equations, simplify expressions, factorise, 
expand, etc, all symbolically. If you could sneak this one 
into a maths examination, you would have a formidable 
ally. QMaths knows about all the algebraic operators, 
powers, roots, brackets, trigonometry, matrices, 
determinants, vectors, factorials, permutations, 
combinations, binomials, exponentials, logarithms, 
hyperbolics, Inverse functions, infinite series Including 
Taylor & Maclaurin expansions, complex numbers, 
conversions, Fourler series, and lots of calculus: both 
differential and integral, induding integration by parts 
and definite Integrals. QMaths optionally displays its 
workings and comes with a superb interactive tutorial. 


The package also contains an interpretive, fractal, image- 
generating language with loads of beautiful fractal 
programs supplied for you to use and edit - no 
programming skill is required. 


There Is also a multiple precision floating point maths 
package, giving calculations at predsions up to over 600 
decimal digits of accuracy. 


There Is even more to this system, but we think we have 
told you enough. 


QMON MACHINE CODE MONI 


The latest version of Tony Tebby's superb monitor: an 
absolute must for those who really want to know what 
Is going on In the QL. No other machine code monitor 
even comes close. 


Do not confuse this program with SuperBasic monitor, 
which monitors SuperBasic, not machine code. 


COMPARE 


This program compares files - data or program - at 
colossal speed. Where a mismatch is detected, the 
relevant areas are highlighted and you can shuffle, 
displace and align very easily. s 


CASH TRADER WITH ANALYSER 


PAYROLL 


Cash trader with Analyser Is an accounts system designed 
by businessmen and not by wretched accountants! 
Consequently, it has excellent reporting and 
management facilities, and is very flexible. It is almed 
primarily at the layman, probably a sole trader running a 
small or medium sized business. All the features you 
would expect - including audit trail - are present. 


Payroll Is a reasonably flexible system designed to 
automate the payroll function in small businesses. 


Both programs are configurable, with editable defaults 
letting you adapt the programs from year to year. 


HARDBACK WITH FINDER 


This Is the ultimate hard disk backup and management 
utility, with all the sophisticated features you could 
want. User dialogue Is via overlapping pop-up windows — 
the whole program Just feels right. It is possible to scan 
the disk at great speed, too. 


DISKTOOL WITH QUICKDISK 


This permits you to add password protection to disks, to 
optionally increase disk storage capacity on DSDD drives 
by 36K and to increase speed of access by as much as 
30%. All this is done while maintaining full compatibility. 
Automatic file management Is also provided. 


DIGITAL C SPECIAL EDITION 


DIGITAL C 


These are extremely fast and efficient C compilers, 


complying with and surpassing the Small C definition. 
The Special Edition goes much further, including support 
for structures, pointers, long pointers, >64K code size, 
direct access to QDOS traps, etc. The Special Edition C 
generates code that runs about twice as fast as the other. 


SPECIAL DEALS 


5% off total if you buy 2 programs/upgrades; 

10% off 3; 15% off 4; 20% off 5; 25% off 6+ 
Upgrades cost difference in price + £10 

Non-UK Europe add 5%, rest of world 10% 


For full terms ond conditions, please refer to any of our QL World ads from Jan—-Nov 1990, or write In Including a SAE 


CPORT IMPROVED VERSION 


A brand new CPORT system, enabling you to rapidly 
convert your SuperBASIC programs into C (ANSI or 
Lattice). The new (October 1992) version is now as 
close to being fully automatic as makes no difference 
— you must get it! 


Owners of our earlier CPORT versions should return disk + SAE for a free upgrade. 


SUPERFORTH COMPILER WITH REVERSI 


Forth is the most logical computer language. This compiler produces multitasking code. 
The manual teaches you Forth-83 from scratch. 


IDIS SPECIAL EDITION 
IDIS 


These intelligent disassemblers make the otherwise terrifyingly complex task of 
understanding other people's machine code programs absurdly easy. The SE version, 
which has a higher hardware requirement, sorts out some routines, replaces addresses 
with names, untangles data from code and much more. 


QKICK FRONT END SYSTEM 


This is a simple, easy-to-master, pull-down menu controlled multitasking front end. QKick 
runs In the background and can be called up at any time. It provides you with notepads, 
sophisticated file/sector/RAM handling, backing up facilities, a clock, diary, calculator, 
mini-database and so on. 


ADVENTURE CREATION TOOL SPECIAL EDITION 


ACT is a must for every programmer. The name of the program Is misleading, Insofar as it 
has capabilities far beyond the ‘mere’ creation of adventures. ACT has utilities providing 
animated graphics, data compression, language design, parsing, maps, object-oriented 
control etc. If all you want to do Is generate adventures, though, you do not need to be 
a programmer to use it. This is a purchase you will never regret. 


PEDIT 


A fast, modern and capable printer driver for the programs bundled with the QL. 


MICROBRIDGE 


Superb contract bridge bidder (ACOL etc) and player, using millions of random but 
reconstructable hands. Microbridge also includes a state of the art interactive bidding 
tutor and a clear Instruction manual. There is nothing like this anywhere else! 


SUPER ASTROLOGER 


A very cut-down version of Professional Astrologer —still great fun, though! 


SUCCESS CP/M EMULATOR 


Allows your QL to run CP/M programs at great speed, 


Please rush me: 


Send to: DIGITAL PRECISION LTD, 222 THE AVENUE, CHINGFORD, LONDON E4 9SE or phone 081-527 5493 


3-D PRECISION CAD SYSTEM 
ADVENTURE CREATION TOOL SPECIAL EDITION 


UTIL ITY 
COPY UTILITY FOR BACKING UP 
CPORT BASIC TO C TRANSLATOR WITH C68K COMPILER 
CFORT BASIC TO C TRANSLATOR 
DATABASE ANALYSER FOR ARCHIVE 
DAT—APPOINT APPOINTMENT DATABASE SYSTEM 
DESKJET/LASERJET DRIVER FOR PRO PUBLISHER 
DESKTOP PUBLISHER SPECIAL EDITION 


ZONE GAME 
DR-DOS v6.0 STATE OF THE ART PC OPERATING SYSTEM 
EDITOR SPECIAL EDITION 
EDITOR 
EYE-Q GRAPHICS SYSTEM 
FONT ENLARG 


ER 

GAMES COMPENDIUM (ALL FIVE one hy 
GRAFIX 24—PIN UNIVERSAL PRINTER DRIVER 
HARDBACK + FINDER HARD DISK MANAGER 


LIGHTNING SPECIAL EDITION FOR GOLD CARD 
MAILMERGE DATABASE SYSTEM 
MEDIA MANAGER SPECIAL EDITION 


NAMES AND ADDRESSES DATABASE SYSTEM 
PAYROLL SYSTEM 

Ae UEROR GOLD SPECIAL EDITION WITH DR-DOS v6.0 179. cae 
PC 

PC 


IR GOLD SPECIAL EDITION 
eo WITH DR-DOS v6.0 


PEDIT PRINTER DRIVER FOR XCHANGE 
PERFECTION PLUS SPECIAL EDITION WITH SPELLCHECKER 
PERFECTION PLUS WITH SPELLCHECKER 
PERFECTION SPECIAL EDITION WORD PROCESSOR 
IRD PROCESSOR 


PROFESSIONAL ASTRONOMER 
PROFESSIONAL PUBLISHER TOOLBOXES (PARTS ONE & TWO) 
PROFESSIONAL PUBLISHER TOOLBOX PART ONE 
PROFESSIONAL PUBLISHER TOOLBOX PART TWO 
PROFESSIONAL PUBLISHER 

FLICK CARD INDEX SYSTEM 
ICK FRONT END SYSTEM 
THS MATHEMATICAL SYSTEM PART ONE 


MACHINE CODE MONITOR v2. 
VER ARCHIVE UTILITY 
REVERSI GAME 
SEDIT + SCREENPRINT ARCHIVE UTILITIES 
SOLUTION PC EMULATOR WITH DR-DOS v6.0 
SOLUTION PC EMULATOR 
SPELLCHECKER WITH DICTIONARIES 
SUCCESS CP/M EMULATOR 
SUPERBASIC MONITOR 
SUPERFORTH COMPILER WITH REVERSI 
SUPER ASTROLOGER 
SUPER BACKGAMMON GAME 
SUPER SPRITE GENERATOR 
TOOLKIT III WITH ROM 
TOOLKIT III 
TRANSFER ee SPECIAL EDITION 


XREF 

KEY>>>»>»»> Available either on cartridge or disk 
Available only on dis. 

Minimum 512K exp: only available on disk 

Minimum 256K exp:either cartridge or disk 

Minimum 256K exp:only available on disk 

Available only on cartridge 

Minimum 1.5Mb RAM:only available on disk 

As well as cartridge or disk, you get a ROM 


Bryan Davies looks at Eros Forenzi on speed benchmarks and 
lan Turner on Pointer Windows. 


The QXL card - a QL-in- 


a-PC - has undoubtedly aroused 
interest. There are few major 
developments on the QL scene 
these days, and anything new is 
bound to excite discussion, but 
something from Miracle Systems 
is always a special event (see 
the Miracle Systems advert in 
this month's issue). As of late 
May, few people had seen the 
card working, but the fact that it 
has been demonstrated 
suggests that it is close to being 
available for sale. Maybe by the 
time you read this, the first 
happy buyers’ will be 
experiencing performance that 
makes even the Gold Card 
seem slow! 

There are various types of 
user to whom the QXL might 
appeal. A user with some very 
demanding software, which 
even the Gold Card cannot run 
fast enough, could find it 
worthwhile to buy both the QXL 
and a cheap PC; simply to get 
the fastest “QL” available. There 
are some very cheap PCs on 
the market, but it is desirable to 
look long and hard before 

. parting with cash, as the cheap 
deals may not be good ones. 
The cheaper systems are 
generally old and lack some of 
the facilities which may be 
required; for example, they are 
unlikely to have high-density 
floppy drives and may not have 
3.5-inch drives at all, the hard 
disk drives (if any) will be low- 
capacity, the display graphics 
may be only mono or CGA 
colour, the keyboard may be the 
old XT style not the current AT 
style. The QXL card can be used 
in either an 8- or a 16-bit 
expansion slot but requires 
EGA-level graphics capability. 

lf you are considering getting 
an old Amstrad PC1640, make 


jUY 


sure it is one with EGA display 
capability; that is, an ECD model, 
not the CD or MD types. The 
display is marked with the 
designation. The computer unit 
itself is marked with the 
designation for the drive types, 
and you need HD for the hard 
disk model. 


Software87 


An early report on the 
combination of Text87 with Line 
Design says that the results are 
good. Graphics and text can be 
printed together. The clip art and 
founts supplied with Line Draw 
are said to be good, and the 
founts can be scaled to a wide 
range of sizes. Sample prints 
certainly suggest the package is 
a good one; the graphic images 
are well-drawn, and print out 
well. Text founts are somewhat 
variable, but the best of them are 
good. Very much to the point, 
when you get into the DTP area, 
the necessary operations for 
producing mixed text-and- 
graphics documents are not too 
complicated. 

Software87 are also working 
on drivers for the Hewlett- 
Packard LaserJet 3 and 4, and 
on a utility program to allow 
character translation strings in 
printer-drivers to be altered 
without recourse to an 
assembler program. The aim of 
the latter is to permit the use of 
“special” characters such as 
box-drawing ones and 
mathematical symbols. 


Bits and pieces 


As of mid-May, the version of 
the Minerva rom being shipped 
was 1.97. The IPC 8049 chip in 
the QL is not without its faults 
and it is worth considering 
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replacing it by the Hermes chip 
(from TF Services). Stated merits 
of the Hermes are the setting of 
different Baud rates for SER1 
and SER2 (both ports have to 
run at the same rate on the 
standard QL), curing of 
“keyboard bounce” with add-on 
keyboards (eg Schoen, 
Keyboard Products), improved 
handshaking with serial input, 
and maintenance of the set 
pitch when sound functions (eg 
fuzzy and random) are used. 

Details on Arcplus, the 
enhanced PC version of Archive, 
have been supplied by 
Transform Ltd. This program is 
not cheap and there would have 
to be a serious, business 
requirement for it to justify the 
cost, and the work of porting- 
across existing QL Archive 
Procedures. However, Archive is 
still a good program and there 
are no doubt plenty of users 
who wish to stick with it, but 
perhaps need the extra features 
that Arcplus can provide. 


Speed test 


Eros Forenzi, one of the prime 
movers behind the Qltaly user 
group, has supplied a disk 
containing a speed-testing 
routine, the QL Speed Index 
(QSI), for the QL and its 
derivatives. Unusually, the 
routine runs under Archive. The 
aim has been to create a 
benchmark test that can be 
applied to any variation on the 
QL theme, and to distribute it 
widely enough to make it a 
standard test, enabling sensible 
comparisons to be made in 
future. This means the routine is 
in the public domain, to be used 
and copied freely. Eros 
compares it to the Landmark 
test used on PCs but, hopefully, 
his test is more meaningful than 
that one. 

It was not possible to 
reproduce the Archive routine 


code here in the time available, 
but please write to me care of 
QL World, enclosing a 3.5-inch 
disk and a stamped, addressed 
return envelope if you want a 
copy. 

As Eros says, we in the QL 
world have not had to bother 
about benchmark tests as much 
as users in the PC world do, but 
we are getting to the same 
situation now. Benchmark test 
figures can easily become very 
misleading if they are not 
applied with great care. Basic 
QL, QL with old disk/memory 
interfaces, Thor |, Thor 20, Thor 
XVI, QL with Trump Card (‘slow’ 
and fast), Atari with (hardware) 
QL emulator, QL with Gold Card 
(three varieties, at least), Amiga 
with (software) QL emulator, and 
now the PC with QXL - there are 
plenty of configurations to 
compare. Eros has not yet got 
test figures for several of these 
configurations, and he asks that 
users running his routine advise 
him of the results (see 
INFORMATION for his address), 
if their QL configuration is 
different from the ones for which 
he lists figures. He suggests 
results be tabulated like this: 


My Qdos system is: 
Computer: eg Atari 
Processor: eg 68030 

Clock: eg 25 MHz 

Other details: eg cache ram 
disabled 

Archive version eg 2.30 


Test results are: 

Elapsed time: eg 900 secs (as 
read from screen) 

QS! QL index 

QS! Gold Card Index 


QSI Absolute speed 


The routine gives three results 
for the speed of the system 
being tested - relative to a 
standard 128 KB QL, to a QL 
with 16 MHz Gold Card, and in 


Standard 128 KB QL 


TIME 
(SECS.) 
869 1.66 


QL + 512 kB Expanderam 5838 1.36 


QL + Trump Card 2 
QL + Gold Card 16 MHz 
QL + Gold Card 24 MHz 


absolute terms (where the 16 
MHz Gold Card system = 100). 
The configurations Eros has 
data for are shown in table one. 

The source (inspiration?) for 
the routine was a commercial 
task Eros had to tackle. This was 
a requirement to convert 
(money) numbers into letters, for 
use in Archive. For example, 
changing 100 to ONE 
HUNDRED. Anyone’ more 
impressed by the original Italian 
might prefer 1002110 coming 
out as UNMILIONEDUE- 
MILACENTODIECI. The test 
routine performs 100 such 
conversions and they are 
printed at the same position on 
the screen; the characters are 
printed in black ink and you 
cannot see anything - as Eros 
says, they would not make 
much sense to non-ltalians, 
anyway! There is no apparent 
problem with testing machines 
fitted with different roms (JS, JM, 
Minerva). The only restrictions on 
running the test are that the 
standard form of Archive (not 
ARCHRTM or ARCHDEV) should 
be used, neither TK2 (Toolkit 2) 
nor any other toolkit extensions 
or accelerator functions should 
be switched on, and no other 
program should be multi-tasking 
with the benchmark. You can 
multi-task programs and use 
speed-up software such as 
Lightning if you wish, but that will 
make the results invalid for 
comparison with others taken 
with “clean” systems. 


Pointer windows 


lan Turner wrote in some 
months ago, on the subject of 
the Pointer Environment In trying 
to understand the workings of 
the PE, he went through the 
tutorials provided on the subject, 
but apparently did not get too 
far. He did, however, learn 
something about re-sizing 
windows, and he sent in an 


INFORMATION 


Arcplus,:Transform Ltd., 7c Station Approach, Hayes, Kent 
BR2 7EQ Tel. 081 462 4666 Fax 081 462 3971 
QSI benchmark:, Eros Forenzi, Via Valeriana 44, 3010 


‘front of me at the 


467 re | 
123 6.56 
83 9.64 


assembly-code 
program for doing 
that job (listing one). 
Some minor changes 
have been made to fit 
the code onto the 
page; it is public 
domain and may by 
now have been put 
into the Quanta 
library. 

Two German QL 
enthusiasts gave us 
disks at the 
Eindhoven show, and 
they may be 
wondering what 
happened to them. 
They are sat here in 


moment, but there 
has not been time to 
digest what is on 
them and make 
comment in this 
issue; all being well, 
they will have been 
looked at more 
thoroughly in time for 
the next issue. 
Switches have 
been in use on 
printers for years - | 
have one. printer 
switched between 
two computers, and 
separately connected 
to a third - but what 
about switchable 
mice? That may 
sound a daft 
question, but mice do 
create a space 
problem, and my 
workbench presently 
has three active mice 
plus two mouse pads 
sat on it. Apart from 
taking up a lot of 
space, the varmints 
cause confusion - 
you sometimes curse 
because the mouse 
you are pushing 
around is not 
interested in the 


Berbenno (SO), Italy. Tel. +39-342-492328 (after 1900 hrs GMT) 
Minerva and Hermes chips:, TF Services, 12 Bouverie Place 
London W2 1RB,, Tel. 071 724 9053 Fax or scrolling modem 


071 706 2379 


QL INDEX 


MODE_8 —_LEA.L 
PAPER_@ 
‘INK_6 MOVE.L 


SIZE_6  MOVE.L 


BORDER_® MOVE.L 


GC INDEX 


9.15 15.38 
6.21 29.92 
9.26 26.34 
1.99 199.69 
1.48 148.19 


Listing One 


ABS. SPEED 
(GC = 166) 


Left: table in reference to 
the ‘Speed Tests" article. 


‘Pointer Windows" article 


* RESIDENT PROCEDURE TO SET WINDOWS #0, #1 AND #2 


* FOR THE POINTER ENVIRONMENT 
* Program Name : WPTR 

* Written by : Ian Turner 

* Date Written : 15 Jan 93 

* Window Parameters: 


* #0 - 512,52,0,204 


- Border 1,224 - Ink 4, Paper @ 


* #1 - 256,182,256,16 —- Border 1,255 - Ink 7, Paper 2 


* #2 — 256,182,9,16 


BLACK EQU 
RED EQU 
GREEN EQU 
WHITE EQU 


WINDOW_9 EQU ® 


WINDOW_1 EQU $10901 
WINDOW_2 EQU $20962 


WINDOWS LEA.L DEFINE,A1 
MOVE.W $110,A2 
JSR (A2) 
LEA.L MODEVAL,A2 
MOVE.B #0,(A2) 
RTS 


DEFINE DC.W 1 
DC.W WPTR-" 
DC.B 4,'WPTR' 
DC.W 9.9.0 
WPTR MOVE.W $112,A2 
JSR (A2) 
TST.L Dg 
BNE.S WPTR_EXIT 
CMP.W #1,D3 
BGT.S BAD_PARAM 
BNE.S PAPER_@ 
MOVE.W @(A1,A6.L),D1 
ADDQ.L #2,$58(A6) 
ANDI.W #8,D1 
BNE.S MODE_8 
LEA.L MODEVAL,A2 
MOVE.B #0,(A2) 
BRA.S PAPER_® 


BAD_PARAM MOVEQ #-15,D0 


WPTR_EXIT RTS 


MODEVAL,A2 


MOVE.B #8,(A2) 


* SET WINDOW #6 


MOVE.L #WINDOW_9,A0 
MOVEQ #BLACK,D1 
LEA.L PAPER,A2 
JSR (A2) 


#WINDOW_0,A@ 
MOVEQ #GREEN,D1 
LEA.L INK,A2 

JSR (A2) 


#WINDOW_9,Ad 


LEA.L DEFINE_@,A1 
MOVEQ #$O6D,D6 
MOVE.B #6,D1 
MOVE.W #6,D2 
MOVE.W #$FFFF,D3 
TRAP #3 


#WINDOW_@,Ad 
MOVE.B #224,D1 

LEA.L BORDER,A2 

JSR (A2) 


* SET WINDOW #1 


PAPER_1 MOVE.L  #WINDOW_1,A 
MOVEQ #RED,D1 
LEA.L PAPER, A2 


JSR (A2) 


INK_1 MOVE.L #WINDOW_1,A@ 
MOVEQ #WHITE,D1 
LEA.L INK,A2 
JSR (A2) 
SIZE_1 MOVE.L #WINDOW_1,A9 
LEA.L DEFINE_1,Al 
MOVEQ #$0D,D0 


- Border 1,255 - Ink 7, Paper @ 


" SuperBASIC WINDOW #0 
* SuperBASIC WINDOW #1 
* SuperBASIC WINDOW #2 


* LOAD ADDRESS OF EXTENSIONS 
* BP.INIT VECTOR 

* ADD EXTENSION 

* SET DEFAULT MODE 

* O=MONITOR, 8=TV 


* ONE PROCEDURE 


* END OF PROCS, NO FUNCTIONS 


* GET INTEGER PARAMETER(S) 

* ERROR ? 

* YES, THEN EXIT 

* ONE PARAMETER ? 

* TOO MANY ! 

* NO, USE DEFAULT MODE 

* GET PARAMETER 

* RESTORE STACK 

* MIMIC QDOS MODE (@ TO 7 =4, 
"8 TO 15 = 8, 16 TO 23 = 4 ETC) 


* STORE MODE 


* BAD PARAMETER ERROR 


* SET WINDOW #@ PAPER TO BLACK 


* SET WINDOW #9 INK TO GREEN 


* SET WINDOW #9 TO 512 BY 52 


PIXELS 


* AT COORDINATES @ x 264 


* BORDER COLOUR 
* BORDER WIDTH 
* INFINITE TIMEOUT 


* BORDER COLOUR 


* SET WINDOW #1 PAPER TO RED 


* SET WINDOW #1 INK TO RED 


* SET WINDOW #1 TO 256 x 


128 PIXELS 


* AT COORDINATES 256 x 16 


RLY 
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Below: listing in reference to 


TF SERVICES 


MOVE.B #9,D1 * BORDER COLOUR 
MOVE.W #09,D2 * BORDER WIDTH 
MOVE.W #$FFFF,D3 * INFINITE TIMEOUT 
TRAP #3 


BORDER_1 MOVE.L #WINDOW_1,A9 


MOVE.B - #255,D1 * BORDER COLOUR 
LBA.L BORDER, A2 
ISR (A2) 


* SET WINDOW #2 


PAPER_2 MOVE.L #WINDOW_2,Ad SET WINDOW #2 PAPER TO BLACK 


MOVEQ #BLACK,DI 
LEA.L PAPER,A2 
JSR (A2) 


MOVE.L 


#WINDOW_2,A9 * SET WINDOW #2 INK TO WHITE 


MOVEQ #WHITE,D1 
LEA.L INK,A2 
JSR (A2) 


MOVE.L #WINDOW_2,A0 * SET WINDOW #2 TO 256 x 128 


LEA.L DEFINE_2,Al * AT COORDINATES @ x 16 


MOVEQ #$9D,D0 

MOVE.B #9,D1 * BORDER COLOUR 
MOVE.W #9,D2 * BORDER WIDTH 
MOVE.W #$FFFF,D3 * INFINITE TIMEOUT 


TRAP #3 


BORDER_2 MOVE.L 


#WINDOW_2,A9 


MOVE.B #255,D1 * BORDER COLOUR 
LEA.L BORDER, A2 
JSR (A2) 


* SET MODE 


MODE_SET MOVE.W #$16,D0 
LEA.L MODEVAL,A2 
MOVE.B (A2),D1 
MOVE.B #-1,D2 
TRAP #1 


LEA.L 
MOVE.B 


MODEVAL,A2 * RESTORE DEFAULT TO MODE 4 
#0,(A2) 


RTS 


* RETURNING TO CALLING PROGRAM 


* WINDOW 


SUBROUTINES 


PAPER MOVEQ #$27,D9 * CALL TO SET PAPER COLOUR 
MOVE.W #$FFFF,D3 * INFINITE TIMEOUT 
TRAP #3 * NOTE: SET A® TO WINDOW NUMBER 
MOVEQ #$28,D0 * CALL TO SET STRIP (SAME AS 
PAPER) 
TRAP #3 
RTS * & Dl TO PAPER COL. BEFORE CALL- 


ING 


INK MOVEQ #$29,.D0 * CALL TO SET INK COLOUR 
MOVE.W #SFFFF,D3 * INFINITE TIMEOUT 
TRAP #3 


RTS 


BORDER MOVEQ #$0C,DO 


MOVE.W #1,D2 * BORDER WIDTH 
MOVE.W #$FFFF,D3 
TRAP #3 


RTS 


* WINDOW SIZE DEFINITION BLOCKS 


DS.W 


v1) 


DEFINE_®@ DC.W 512 * WIDTH 


DC.W 52 * HEIGHT 
DC.W ® * X COORD 
DC.W 264 * Y COORD 


DEFINE_1 DC.W 
DC.W 182 
DC.W 256 


DC.W 


DEFINE_2 DC.W 256 
DC.W 182 
DC.W Us) 
DC.W 


MODEVAL DS.B 


END 


screen you are looking at. An infra-red mouse (see review of the SERMouse 
mouse driver) does relieve some of the cable clutter, but one has to face the 
fact that computer systems consume large amounts of space, and that space 
is needed for other things, such as the paperwork the systems generate. 
Maybe one infra-red mouse and three infra-red receiver units would be an 
answer for me, but what happens if more than one computer reacts to the 
mouse activities? Amazing how computers provide endless occupation, 
without driving one to terminal distraction or boredom. 
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MINERVA HERMES 


4 A replacement QL co-processor for 
MKII MINERVA with battery for 256 bytes the Obs awfal IEC 8049 
Quick 


CRASHEROOE clothe & 

Can autoboot from - Do you get keyboard bounce? 

- Do you find fast serial mput unreliable? 

- Do you want to connect a modem at 19200bps 


If you can say YES to any of these, 
then you need HERMES 


+ 19200bps RELIABLE serial input - NO QCONNECT. 


baud rates with Hermes. 


Ist upgrade: free, Otherwise £3 (+ £5 for manual if requd) 
(send sae, rom & NEW disk/3 mdvs) 
MKI to MKII upgrade - £30 


MKI....£40 MKIL.....£65 


BOTH VERSIONS GOLD CARD COMPATIBLE 


Fitting is simple. Remove the QL top (8 screws) & 
replace the chip marked 8049 or 8749 next to mdv 1. 


£25 including manual/software 


I2C Interfaces 


The FC bus was designed by Philips to simplify 
interfacing. Minerva MKII clock is driven by an PC 
chip, & a connector allows connection of other circuits, 
Our extemal circuits will imtcrconnoct without leads, 


Parallel Interface Up to 4 can be connected powered 
by the QL. Each gives 16 input/output ports, Can be 
used wherever logic level signals are required - 


QL REPAIRS ats 2 BGIeIeUAOR 


uc__Interfac: 
connected & powered off QL. Each gives 8 analogue 
to digital imputs, and 2 digital/analogue outputs. For 
i £30 


Other aay, bral etc) please phone 


Fixed price for unmodified QLs, excluding microdrives. 
QLs tested with Thom-EMI rig and ROM software 


£27 including 6 month guarantee 


All prices include post & packing (UK only). Payment by Mastercard/Visa/Burocard/ 


transfer (58 267 3909). MAIL ORDER ONLY - no callers without rimging first. 


12 Bouveric Place, LONDON W2 IRB 


Tel: 071-724 9053 Vax: 071-706 2379 


MasterCard | 


eg rr gd) 
recorssacvae (EEC) WA Richardson & Co. 


18-21, Misbourne House, 
Chittarn Hill 
Chater SLO SUE 


All Prices Include 17.5% VAT 


QL Computers} NEW MONITOR £50 CHEAPER 


JS COMPLETE X. Computes, PSU, TV. Lead, PSION V2.35 Software [ord Processor, Spreadsheet, 
Haass mentee ees. som Gceanicsres ity =t20 
years 
free library programs, Newsletters & WARRANTY. WITH DM ROM £100.00 


25 ge TME6S Cubekalbeptoppeewtie eae 


i NOTE: EXTERNAL 3 BUTTON MOUSE AND SOFTWARB 
Accessorics ware ETA cen ence samen maemo A ish 
PC KEYBOARD INTERFACE, INTERNAL FITTING, FOR FITTING 102 KBY KEYBOARD £75.00 
PC KEYBOARD, UK version, 102 key (AT) £ 30.00 
PC KEYBOARD INTERFACE and KEYBOARD (INCLUDES FREE JOYSTICK OR PSU) £95.00 
pe emi Sa T-plan pied 


JOYSTICK with QL lead (no interface required) 10.00 
* QL MOUSE, 3 Button, Software controlled, externally mounted, simply fits In SER2_ £45 CORDLESS MOUSE £5500 


; ; THE UNIVERSAL DRIVES ARE ALSO SUITABLE FOR ACORN BBC. ATARI ST, 
Disk Drives] Tiign SPECruUMS IBM AMSTRAD AND OTHER PS CON is 


Universal 3.5° 1Mb disk drive, cased with PSU and free QL lasd £ 70.00 2 Units for dual drive £120.00 
Universal SSEae PGs Selves 33 above bax 2M capacity £90.00 2 Units for dual drive £170.00 
3.5" IMb Uncased disk 225.00 
35" 2b Uncased dk drive £ 49.00 
Lead for uncased disk drives, or other universal micros £10.00 POWSR SUPPLY FOR UNCASED DRIVES £ 6.00 


METAL CASES POR UNCASED DRIVES £ 6.00 


Parallel Printers } NEW RANGE 


SAMSUNG SPOS3 80 Col, 300 cps, $0 NLO, 3K Print Butt Tractor Feed/Sheet Feed, Paper Pak £149.00 
rr COLO UR PRINTER 24 Bid ce SO NLR, di Bull, Hen LQRSSYIEN Campa £259.00 
QL LEAD POR SERIAL PRINTERS €10 ; CANNON BJ10 EX 


PHILIPS 14” HIGH RES COLOUR EGA .31 DOT PITCH, FULL 85 COL 
WITH AMBER OR GREEN TEXT FEATURE, IDEAL FOR WORD 
x PROCESSING, RECONDITIONED, 90 DAY WARRANTY. 
OK FOR PC AND QL SELF SENSING AND MANY EXT/L CONTROLS. | 


(isodire Cait at Sues] SAREE 9.3. 
2° GREEN SCREEN, 


“reeaty ata £1000 8 prog carts for reformatting in'2 wallets bere] 
PaneSemee fe Bling box lacking mew cartridges 
hese ‘5 Baten Qa Ac Ahi nd Es DN WALLET £n0o 
Separate programa £ 10.00 
QL power Supply Unit 2 10.00 Membrane (and instructions) £ 9,00 
Ot me uty £ 3.00 QL Top & Bottom Case £ 3.00 
ICs = ZX 8301 £6.00 ZX8302 £ 3.00 8049 (IPC) £ 3.00 MC 1377 £& 3.00 
MC 68008 £12.00 
QLSERVICEMANUALS&cRcUT, =« p50 «s PAE FOR FURTHER DETAILS 


Payment terms: Delivery: 
CWO, Access, VISA et cetera Carriage - £9 


ae secon rae Postage - £5 
3S TEL: 0753 888 888866. FAX: 0753 887149 


Psion open door to QL Xchange 


Following ground-breaking enquiries by Mike 
Bedford-White and Simon Goodwin of the West 
Midlands Quanta group, and a communication 
from Helmuth Stuven, formerly of Thor International 
and Dansoft, QL World contacted Psion to check 
the status of all versions of Psion Xchange for the 
QL known to us. 

Psion Xchange is Psion's name for the suite of 
four programs - Quill, Abacus, Archive and Easel - 
that were bundled with the new QL from the start 
of its career. Various upgrades of these programs 
have appeared, notably Thor Xchange, a partially- 
rewritten version produced by Dansoft for the Thor. 

Further upgrades and adaptations of the 
programs have been produced privately by 
programmers who want to see them widely 
available to QL users. QL World’s enquiry was 
about the copyright and distribution status of the 
four programs. Psion's replied: 


“Thank you for your letter regarding Psion 
Xchange. | am happy to clarify the position. We 
are quite happy for the four software programs, 
Abacus, Archive, Easel and Quill for the Sinclair QL 
or derivative machines to be freely distributed for 
use on the QL and derivative machines. We retain 
copyright at all times. 

‘The re-write made for the Thor computers by 
Dansoft was done under licence from us, and we 
retain copyright to part of the code. As described 
in the point above, we are happy for this to be 
distributed without charge while retaining 
copyright. 

“The product PC-Four for the IBM-PC or 
machines running MS-DOS emulation is not 
included in the above, and remains a product we 
sell. We would be most unhappy to find this 
product in the public domain. 

“In summary, we are happy for QL specific (or 
derivative products) software to be distributed 
freely to users while retaining our rights. We are 
not pepared to allow IBM PC (or derivative) 
versions to be distributed freely, 

“We trust this makes it perfectly clear, and | trust 
that this will not prevent the QL community from 
continuing to enjoy their Psion software. 


“Peter Norman, Group Commercial Director, 
Psion PLC, London NW8.” 


This letter confirms Psion’s letter to West Midlands 
Quanta, and makes it clear that they are happy for 
the whole QL public to enjoy free distribution of the 
Xchange programs for the QL It also clarifies that 
Psion retain all their copyrights in the programs, 
which can be distributed and adapted, but not 
cannibalised for commercial programming. The 
status of Psion Xchange programs for the QL is 
somewhat like Shareware, but without registration 
fees, documentation or support 

Psion also make the point that Xchange for the 
PC (PC-Four) is a commercial product not free for 
copying by users. 

Helmuth Stuven's letter to QL World earlier this 
year donated the programs bundled with the Thor 
in which he had an interest to the public domain. 
All code belonging to Psion (including that 
incorporated in Thor Xchange) is governed by 
Psion's terms, but the effect to the QL user is the 
same: the programs can be freely distributed. 

Ex-Dansoft workers Gunther Strube and Erling 
Jacobsen have modified Thor Xchange 3.90 to run 
on the QL and compatibles. This version can be 
obtained from them by sending a formatted 720K 
QL disk and sufficient International Reply Coupons 
for return post to Gunther Strube, GL Kongevej 37, 
2nd, DK-1610 Kopenhagen V, Denmark. 

Thor International also supplied Psion Chess in 
a disk version for the Thor. This program has been 
adapted to execute as a job (CALLd on the QL 
and not multitasking). A copy is available to users 
sending a disk and reply coupons, plus their 
original Psion Chess microcassette as proof of 
purchase. Psion Chess is not covered in Psion’s 
release terms for Xchange. 

Of the various versions of Xchange for the QL in 
existence, most should be available soon from 
public domain suppliers for their usual copying 
charges, or from a friend. 

Established users claim that the Xchange 
upgrades for the QL offer considerable 
improvements on versions originally bundled with 
the QL 


Demos /it town 


The latest additions to SJPD's lists are Xchange 3.90 from Psion, two disks of C programs from 
Richard Kettlewell, comprising YACC (a compiler), MAKE (a new version), C Toolkit, Flex and utilities; a 
David Walker Demo Disk with versions of Textidy, MultiDiscover and Discover, and a shareware 
version of FLPClone disk copier; a demo disk of Di-Ren's Fleet Tactical Command 2 (QL and PC 
versions available); Speculator, the new Spectrum emulator in English; QL-REXX, a REXX interpreter for 
the QL, and DME, a Pointer Environment (not supplied) text editor ported from the Amiga. 

SJPD's printed catalogue is available for four first-class stamps. For the up to the minute information, 
their disk catalolgue is available free to anyone sending a formatted disk, return postage and an 
address label. This disk also contains some free sample software. 

SJUPD’'s new arrivals reflect how keen many software writers are to produce demo versions of their 
favourite programs at a low cost, so that QL owners can see them in operation and try some of the 


functions before pledging large sums of money. 


Contact: SJPD, 36 Eldwick St., Burnley, Lancs. BB10 3DZ. Tel. 0282 451854. 


New - 
QReview 


We have just heard that Bruce 
Nicholls, publisher of QL Leisure 
Reivew and QL Technical 
Review (formerly published by 
CGH) is closing those two titles 
and publishing a new title, 
QReview. Existing subscribers 
will continue to receive the new 
title, and back issues of the 
previous titles will continue to be 
available from Bruce at Quo 
Vadis Design, and also from 
Dilwyn Jones. 

More detail next month. 
Enquiries to Bruce Nicholls at 
Quo Vadis Design, 57 
Shaftesbury Road, Romford, 
Essex RM1 2QJ. Tel. 0708 
755759. 
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Channel 


Open Channel is where you have the opportunity to voice your opinions in Sinclair QL World. Whether you want to ask 
for help with a technical problem, provide somebody with an answer, or just sound off about something which bothers 
you. Write to: Open Channel, The Blue Barn, Tew Lane, Wootton, Woodstock, Oxon. OX7 IHA. 


| recently bought a second 
hand Z88 notepad computer. 
Unfortunately, it has already died 
on me, and the seller is nowhere 
to be found (caveat emptor ..), As 
so many QL owners have one of 
these, | would be grateful if 
anyone could let me know 
where | could have mine 
repaired and at what cost. | have 
written to the Z88 users group 
but without success. It's possible 
that | had an incorrect address. 
Also, does anybody have or 
know of a Quill printer driver for 
the Citizen Swift 24? (| believe it 
can emulate the Epson LQ500 
among others.) | have never 
heard of such a driver, but | live 
in hope. 
Jean-Yves Rouffiac 
Gospel Oak 
London 


In 1990 the Z88 handbook 
listed the following in the 
London area as Z88 registered 
dealers: Radio Shack in NW6, 
Hardware Trade Tech in NW10, 
KK Stationers in W2 and Micro 
Anvika, PC Consultants, 
Gultronics, Megateck Computers 
and G&B Computers in W1. 
Addresses and phone numbers 
are constantly shifting, so it’s 
over to you from. there. 
Otherwise, it's a matter of finding 
a reputable computer dealer in 
your area and getting a 
quotation for the repair. 

But your best alternative is to 
contact Cambridge Computer. 
Their office number is now 0294 
222100, but they have a repair 
depot in Cambridge at EFS Ltd, 
Unit 4, Chesterton Mill, French's 


u 
San 


Road, Cambridge CB4 3NP. Tel. 
0223 353355, and ask for Amos 
Fulcher. 

Caveat emptor! You can’t 
normally claim recompense 
from the seller of a second-hand 
computer if it was sold as seen 
in good faith. 


Catch « Mouse 


It was nice to meet you in 
Eindhoven. As pointer software 
gets more attention in the UK, 
also the interest of connecting a 
mouse to the QL seems to be 
growing. My SERmouse driver 
for a serial PC mouse seems to 
be the only available mouse 
solution of its kind for the QL, 
and | think it would be 
interesting for your readers to 
find a review in QL World. 

Albin Hessler 
Aichtal 
Germany 


It’s in this issue. The Qimi 
house interface, and the 
QLMUG mouse interface and 
still available if you know where 
to look for them - try Quanta. 
Albin’s mouse — software 
development has the Pointer 
Environment very much in mind. 
See page 28. 


Minerva-wise 

| was disturbed to see Bryan 
Davies’ speculations about 
Minerva in the — April 
Troubleshooter. Firstly, a 
computer that doesn't develop 
will die all the sooner. | find it 
staggering that he expects the 
operating system to be archived 
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in 1986. There are some 1200 
Minerva users out there (based 
on my sales records). It is not 
realistic for him to dismiss 
Minerva as “tinkering”. 

Also, he reported problems of 
using a “released” version not 
working with Professional 
Publisher or the Pointer 
Environment. In fact, this was a 
beta test version! | have 
discussed this with him. | also 
asked him what the rpoblem 
was with the Pointer 
Environment, and he said he 
didn't know. The only problem 
we had was_ something 
Laurence (Reeves) was trying to 
do with Multibasics. When we 
found it didn’t work on beta test 
we removed it. 

The released version 1.97 
doesn't have problems with 
either the Pointer Environment or 
ProPub, to our knowledge. The 
current problems are now very 
few, when the suggestions 
made in our documentation are 
followed. | would be grateful if 
you could correct the false 
impression given. 

Tony Firshman 
TF Services 

12 Bouverie Place 
London W2 1RB 


Glad to. When Minerva first 
appeared, based as far as 
possible on the most advanced 
Sinclair QL rom developments, 
there was_a bit of friction about 
differences with the rom which 
software writers had been 
working with. One party of 
supporters argued that software 
writers had to follow the most 
widely-used standards and that 
new developments should take 
this first into consideration. The 
other party argued that the 
Minerva rom was of a purer, 


older lineage and did things 
properly, and that software 
developers should be adapting 
to that not the other way round. 

Since the dust died down, 
quiet and steady work on both 
sides has meant that there are 
now very few incompatibilities. 
The ideological gulf can be 
argued both ways, but in reality 
people have adapted to get the 
best of both worlds. 

The East Anglia Quanta 
Group also market a neat rom- 
switcher for those users who 
want to use two different roms. 
The contact is Chris Howard at 
13 Oak Grove, Horsford, 
Normich, Norfolk NR10 3DR, tel 
0603 891 183. 

People close to the beta-test 
circuit often seem to be 
uncertain which is the current 
release of Minerva, but Tony 
always knows what the latest 
situation is and will always give 
the best advice. Speak to his 
answering machine on 071 724 
9053, or fax/scrolling modem 
071 706 2379, 


Not a patch 


E B Palmer (Open Channel, 
April 1993) whether there is any 
way the abacus layout can be 
expanded beyond 255 rows 
and/or 64 columns. 

Having seen this question in 
your columns before, may | lay 
the ghost once and for all? | 
looked at this problem a few 
years back, as | too was 
annoyed by the limitation 
imposed by 256 rows and, at 
the time, no other QL 
spreadsheet had seen the light 
of day (there is now QSpread). | 
have since chucked my notes 
away, but the following thoughts 
from memory may clarify the 


position. 

To put it bluntly, there is no 
possibility of a patch to Abacus 
to increase the number of cells. 
In the first instance, all the Psion 
suite of programs were originally 
coded in high-level code, then 
cross-compiled for the QL; later 
versions of the Psion suite were, 
| believe, partly hand coded in 
machine code to optimise them, 
but the resultant code is, 
nevertheless, very hard to 
understand and hence patch. 

Worse still, the 256 row 
limitation is imposed in the 
machine code by the use of 
word length pointers to cells (8 
bits (one word) allows the 
representation of decimal 0 to 
255, no more). The 64-columns 
limitation is similarly imposed (6 
bits gives decimal 0 to 63, the 
other two bits are used as 
formatting flags). To increase the 
size of the spreadsheet 
therefore, all instructions which 
use the cell pointers would have 
to be changed from word-length 
to double-word-length (16 bits). If 
one imagines how much of the 
program is devoted to 
manipulating the contents of 
cells (almost all of it!), it can be 
seen that the change required is 
not a patch, it is a total rewrite! 
Without the original annotated 
source code and developers; 
documentation, this would be 
likely to take longer, and be 
more expensive, than writing a 
new spreadsheet program from 
scratch. | am afraid Mr. Palmer 
will need to look elsewhere, 
possibly, as Howard Clase 
recommended, at QSpread, for 
his solution. 

Malcolm Bacchus 
London SE14 


QSpread has an increasingly 
enthusiastic following among 
QL users as word gets around. 


Connections 


Regarding my earlier letter 
(March 1993) about the joys of 
Qram and similar programs, 
since | wrote that letter Mr. 
Dolezal has been in touch with 
us and sent us a cheque for 
£30 as a refund for the Q-Top 
which | returned because | do 
not have Toolkit 2. 

On to other things. | have a 
Tandata communications unit 
with which | used to use Prestel, 
and to communicate both to 
and from other numbers until | 
gave up Prestel. | would like to 
see more in the magazine about 
communications over the 
telephone network, because | 
have no contacts since giving 
up Prestel. | have tried the 


numbers of so-called bulletin 
boards but with no connection 
to date. 

Also, | have two Psion 
Organiser XPs with 32KB which 
| use even more than | use my 
QL one with the wordprocessor 
and one with the spreadsheet. | 
have the Textbase database 
program for both of the XPs, and 
can transfer from the XP to the 
QL Archive. | would use the QL 
even more if | could transfer 
script and numbers to it from the 
XP direct instead of through 
Textbase and Archive. 

Is there sufficient interest in 
such subjects to have more 
information about them in the 
magazine? 

Lawrence Carpenter 
Guernsey 
Channel Islands 


We've got something on 
bulletin boards coming up. Try 
talking to Tony Firshman at TF 
Services (via his answering 
machine) and Bob Weekes at 
Pointer Products (0258 455117 
voice and fax), who both run 
bulletin boards. I’m always 
interested in hearing from 
people who are piping data 
between the QL and other 
computers, to learn their 
methods. We'll look at putting 
together an article on it if 
enough people are interested. 


Why are all your contributors 
so serious? Is there no-one out 
there who uses the QL to have 
fun? And | don't mean just 
playing computer games. | 
notice that you have just started 
a new serious of articles for the 
absolute beginner. Can there 
still be people who look glassy- 
eyed at the box and wonder 
what to do with it? 

Take my case, for example. | 
have had a QL for about six 
years, working up from a ZX81 
and a Spectrum. | can't 
understand multi-tasking and 
don't see why | should want it 
anyway. Two-thirds of the 
instructions in my Toolkit 2 are a 
mystery to me, and a fair bit of 
the manual besides. If | don't 
use an instruction for more than 
a week, | have to learn it all over 
again. But | get a great deal of 
pleasure in writing a program in 
SuperBasic to do something 
probably quite useless, and 
trying and eventually 
succeeding in making it work. 
Am | the only person among 
your readership who operates 
on this level? 

For example, | have written a 
program to simulate the 
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Editor’s notebook 


users. 


operation of the German 
wartime coding machine 
Enigma. How about publishing a 
small message in code and 
challenging all the experts to 
decode it and to explain how 
they did it? To give them a 
chance you would need to 
publish the program as well. 
George Phelps 
St. Leonards 
East Sussex 


That's the best sales pitch I've 
heard for some time. 


When in Rome 


Regarding your article on the 
QL International Meeting, a 
small correction: the photo 
showing the Qltaly stand was 
really the Ergon stand! | am the 
first from the left sitting, and then 
there is the ‘artificial intelligence’ 
guru Marco Ternelli, who was 
showing ZM/hT to Roberto 
Orlandi of Qltaly Club. 

Keep up the good work on 
QL World. 

Davide Santachiara 
Reggio Emilia 
Italy 


You're quite right! Qltaly had a 
banner slung along the pillars 
behind the stand; when they 
weren't circulating, Eros and 
Roberto were ‘hanging out’ with 
the Ergon bunch - doubtless 


Probably the most Interesting news this month - 

- and It’s not news, of course, to those who have 
been working on It - Is that Psion have definitely 
declared that they are happy for versions of Psion 
Xchange (the Psion Quartet) for the QL and Its 
compatibles to be circulated freely by all QL 


Psion are not the first copyright owner to take 
the view that, once a plece of thelr software 
bundled under licence Is no longer being actively 
marketed, upgraded and supported, then, 
provided there Is no trespass on the owner's 
activities, users of the machines concemed are 
free to work on and adapt that software. 

This does not amount to Public Domain rights, 
but It does mean that QL (and Thor) Abacus, 
Archive, Quill and Easel can be freely upgraded, 
copled and shared. More Information In QL Scene. 

We found Mike Lloyd. He Is a very busy man at 
present, but you may be sure that we are 
contributing to his busy-ness! 


planning the joint QL Italy 
Meeting this coming September 
(see QL Scene). 


Cheers! 


Thank you for QL World - 
reassuring, inspiring, and always 
the prospect of even better 
things to come. You are all 


greatly appreciated. 
Malcolm MacLeod 
Aberdeen 
Thank you, ~—- Malcolm. 


Renewals with the personal 
touch! 


Late letters 


(Slightly condensed): why do 
some letters get printed a long 
time after they are sent? 

Alan Ingrey 
Peterborough 


A few letters get hived off so 
that | can ask around for 
answers. If | dont get an answer, 
| run the letter in Open Channel, 
say, three or four production- 
cycles later (or whenever the 
letter re-emerges from the 
system), in the hope that it will 
be seen by someone who has 
the answer. | forward several 
‘answer’ letters a month, and 


_ print some of them, so it works 


pretty well. QL World is in the 
business of sharing problems 


juny 
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and ideas, so appeals in a 
publishable form are the best 
kind. 

Our “lead time” for urgent 
things is down to three or four 
weeks now the best it’s ever 
been. 


Take notes 


Help! | urgently need a 
method of writing musical 
manuscripts on my QL | would 
prefer to be able to connect a 
keyboard via a Midi interface 
and have the computer print the 
music as | play, or at least 
comiple the music in notation 
form to print later. 

| cannot see any way to 
purchase a Midi interface for my 
QL Is there a company that sells 
these devices? | don’t want to 
have to go to the great expense 
of converting to a PC to 
accomplish this. 

J G Wilkinson 
Southampton 


Yes! Quanta themselves 
market the former Miracle Midi 
interface. As for software, there 
was, two or three years ago, a 
decent notation program for the 
QL which was reviewed for us 
by Eleanor Patrick, who is a 
Quanta member in the Leeds 
area. | don't think it fed notation 
straight to memory, though. Not 
many low-cost programs do. Try 
Quanta chairman Bill Newell at 
213 Manor Road, Benfleet, 
Essex SS7 4JD and see if he 
can assist. 


| spotted a couple of queries 
in Open Channel earlier in the 
year which | thought | might be 
able to answer. First, ZX Basics: 
the Spectrum Basic is actually 
closer to ZX81 Basic than the 
ZX81 version is to the ZX80, 
although there is still a large 
amount of extra code. There is 
actually a piece of code in the 
Spectrum rom that is not used, 
but is a leftover from the ZX81; 
presumably someone forgot to 
remove it! 

SuperBasic being “tagged 
onto Qdos” doesn't necessarily 
mean it was designed for 
another CPU. The original 
intention - according to what I've 
read - was for GST to write the 
QL's operating system, so 
perhaps SuperBasic was 
originally designed for that. 

On the subject of GST, their 
assembler and compiler are 


gun 


now being sold to members by 
Quanta. The assembler has 
been updated a bit, and | can 
highly recommend it. As for the 
C compiler, C68 is a better bet - 
free apart from disk copying 
charges from Public Domain 
dealers - unless you're short of 
memory. 

Richard Kettlewell 
Bournemouth 
or Cambridge 

(rik1002@uk.ac.cam.phx) 


Antique disks 

A while ago a correspondent 
reported trouble reading disks 
which had been written-to some 
years previously. This has 
happened to me, too, and the 
trouble was not worn drives, as 
these had been laid up as long 
as the disks. The disks were all 
master copies from 
softwarehouses, and unbranded. 
Other disks stored in the same 
disk box (branded) were all OK. 
The moral seems obvious. 

A particular degree of 
magnetism in a substance is 
not totally fixed and stable over 
time. A lower quality disk will be 
magnetised less in the first 
place and so liable to suspect 
reading first. Fortunately, due to 
their age, my disks were written- 
to on DD drives, and could 
mostly be read on an ED drive 
which has more sensitive read 
Circuitry to cope with the higher 
recording density. 

The one disk | couldn't 
recover this way was from Sector 
Software. Joy of joys, they 
responded to the answerphone 
and offered to rewrite the disk for 
the cost of the return postage, 
but the suspect disk and several 
follow-up pleading letters seem 
to have disappeared into a 
black hole somewhere in 
Lancashire. Of course, | didn't 
have a backup. Sad. 

Please, please, please don't 
give up on Mike Lloyd's 
Keyword Index, which has been 
absent for the last few months. | 
should be happy to pay 
photocopy fees to get mine, if | 
must. There are quite a few 
alternative (if elderly) publications 
on SuperBasic, but not on the 
Toolkits. | would be grateful to 
hear what is happening to this. 

In general, things have 
improved post-Maxwell, apart 
from the occasional writer who 
assumes that readers know all 
about widgets and just need the 
SP on this — particular 
implementation. What about 
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some editorial in a sidebar to 
deal with this problem? | think 
that the Q_Lib manual is a 
model of clarity others should 
aspire to. 

The quality of software seems 
much improved over the last few 
years, even if there is less of it. 
That does mean we may have 
to rely on our own programming 
a bit more. Hopefully this will 
influence your output! 

Ivan Hall 
Lapford 
Devon 


Several interesting points here. 
The elasticity of the time domain 
is one of them: Mike’s New User 
Guide has been absent for two 
months, the latter one because 
he misread his copy date! Mike 
is setting up his own computer 
business in his spare time, and 
this is taking a great deal of 
work and brain-power. | trust he 
will note how he is appreciated. 
Often writers don’t get any 
feedback unless there is an 
error! 

| spend a good deal of time 
trying to get authors to hit the 
right level in articles, especially 
the technical ones, but it isn’t 
always practical to take 


everything back to basics. If you 


are following an article where 
something isn't clear to you - 
drop us a line, and we'll get the 
author to expand on it 


l'm pleased to see Fred 
Toussi taking a high profile and 
accepting the praise and 
comments on his tremendous 
Text87 Plus4, and also to see 
his replies in Open Channel, as 
well as to have received 
personal communications. 

The Spellchecker on his 
wordprocessor does more for 
me than any other | have tried, 
and | wonder at those who are 
content with a simpler approach, 
or dismiss the notion that it is 
necessary at all! 

| am not looking for a device 
which corrects my syntax and 
semantic errors, but there is a 
long list of words that | 
commonly use - medical 
psychological terms, my own 
notations, etc, as well as 
common typing errors - that it is 
welcome to have picked out. In 
fact, my intention is to praise the 
Toussi Spellchecker in favour of 
my “work area’ program simply 
because it does not come up 
with “guessing game” varieties 
of what has been typed in. 

My next obvious move is to 
install a Gold Card with a pair of 


ED drives. | can’t wait! Freddy 
Vachha put on a tremendous 
demonstration of the speed 
possible running Conquerorr 
Gold SE, which | have, although 
regrettablywithout the DR-DOS 
to make it usable. It has joined 
some other things on the shelf 
to await finance and time, but 
holds a prospect for the future, 
In the meantime, before 
Freddy points it out (!) | have 
taken the opportunity to upgrade 
my copy of Perfection again, 
although | still prefer the text87 
spellcheck side of things at the 
present date. | was anxious, but 
alas unable to take advantage 
of DP’s “special show discounts”, 
so this is as far as | can stretch 
just now! 
L Ross Bayne 
Reading 


Open Channel 


Italy in 
September 


The 5th Italian QL Meeting - 
organised by Ergon 
Development and the Qltaly 
club - will again be held in 
Reggio Emilia on Sunday 26 
September 1993 as a whole-day 
event. Early information can be 
obtained from Davide 
Santachiara on +389 522 70409 
or Eros Forenzi on +39 342 
492323. The Italian Meeting is a 
regular for several international 
QL dealers, and they are very 
much hoping that Miracle 
Systems will be there with the 
QXL 


QXL in USA 


Miracle Systems shipped their first release models of the QXL QL-in-a-PC card at the ILQR Show at 
Newport, Rhode Island in America’s New England on June 5th. 

The full SMS/Q operating system, developed by Tony Tebby, was not fully complete at the time of 
shipping, but all the basic functions are in place and Miracle's Stuart Honeyball is expecting the 
remainder of the software to be despatched to users at the end of June. 

At present the QXL floppy disk handling is up and running, so that the card is fully internally functional. 
Work is in progress on the print functions, the hard disk and parallel port functions, and the interpreter, 
which is being written by Laurence Reeves of Minerva fame. 

Already several UK users have been able to load software up on the QXL during demonstrations and 
see it running. Interest in the QXL was “pretty good” in New England. The IQLR Show was attended by 
about 60 QL enthusiasts from all over the USA and neighbouring Canada (new England is “not far’ - a 
mere 200 miles - from the Canadian borden). 

Miracle’s Stuart Honeyball, himself no mean traveller, was struck by the distances covered by US 
visitors. He met one user from Alberquerque, and another who had driven the best part of 1,000 miles to 
Newport, One QL World reader came from Canada after seeing the announcement in the May issue. 

The UK contingent were Stuart, Tony Firshman (TF Services) and Bill Richardson (EEC). At opposite 
ends of the high-tech scale, Stuart spoke highly of Virgin Atlantic's Super Economy service - “Most 
enjoyable flight, passable food and plenty of space” - and spent the Thursday of their arrival cycling 
round Rhode Island with Tony Firshman. 

Miracle are themselves sponsoring a QL meeting - in Belgium, on 17 July 1993. The location will be 
the Eurovolley Hall, Beneluxlaan, Vilvoorde, Brussels, For more information, see next month's QL Scene, or 
contact Miracle Systems on 0904 423986. 


Small Laser Printers 


Rank Xerox introduced two new ‘entry level’ 
(small and low-cost) laser printers to its range in 
January. ‘Small and low-cost’ for a laser printer is in 
a different ballpark from printers of other types, but 
nonetheless laser printers are now getting the 
attention of serious users who need high-quality 
print output 

The smaller model, the Xerox 4010 Il, includes 
HP Laserjet II (PCL4) emulation and costs £869 
with one-year on-site warranty. The Xerox 4010 Ill 
has HP Laserjet Ill (PCL5) emulation, a 3-year on- 
site warranty and costs £1,095. 

Both models operate at 4 pages per minute, 300 


dots per inch and are designed to handle up to 
5000 pages per month. The 4010 II has standard 
512K ram. The 4010 Ill comes with 25MB of ram, 
and both can be upgraded to 4.5MB. There are also 
upgrade kits for other industry standard emulations. 
The machines will handle A4, US letter or US legal 
paper sizes between 60 and 120 gsm weight, as 
well as envelopes, transparencies and other non- 
standard stock. 

Ink-jet printers have offered a lower-cost 
alternative to laser printers for good-quality output, 
although they do not match the versatility of a laser 
printer, and some users have found problems with 
ink-handling, 
The Hewlett 
Packard Deskjet 
is probably the 
leading inkjet 
range, used by 
many QL users 
with excellent 
results. 

Information 
from dealers or: 
Rank Xerox 
UK Ltd., Bridge 
House, Oxford 
Rd., Uxbridge, 
Middx UB8 
1HS. Tel. 0895 
251133. 
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New I/O from Falkenburg 


W N Richardson (EEC) have their hands on a new QL multiprocessor input-output interfacing system 
from German developer Jurgen Falkenburg. The !IO-Card has an on-card integrated 80C51 24-MHz co- 
processor, a user-friendly Basic Toolkit, and its own dual-ported 32K static ram, which can be used for 
programming in addition to the QL’s own commands. 

Falkenburg describes the Card as being switchable to be compatible with any QL system, including 
the Gold Card, He suggests scanner, sound-sampler, oscilloscope, logic analyser, model controller and 
frequency generator as just some of the types of function which the !l|O-Card can be applied to. 

A preliminary product leaflet with further information can be obtained from W H Richardson & Co., 
18-21 Misboume House, Chiltern Hill, Chalfont St. Peter SL9 QUE. Tel. 0753 888866. 


sensors of any kind, 


address selector 


microphone, amplifier, 
temperature, scanner ... 


amplifier, loudspeaker, | 
control input ... 


any TTL-signal source, 
mech./electr. switch, 
digital sensor, 
comparator, 
computer/peripherals 


8 Bit 1/0 
8 Bit 1/0 


—_— 
—_> 
> 
> 
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lamp, relay, motor, 
stepper, control input, 
computer/peripherals 


~ | B Bit I/O 
32 KByte EPROM 


8051-operating system 


Extended 
Spectra 


Simon Goodwin 


QL in any state of expansion] 


The full Soeculator release is at last complete, and available from 
Qubbesoft, SUPD and the Quanta library. This freely-distributable 48K 
Spectrum emulator has been extended since the review in April's QL 

World. 

‘Fast machine-code routines to convert programs and screens into 
QL format replace the original C and SuperBasic code, and dozens 
of Toolkit commands have been added to make it easier to 
manipulate ZX programs and data files from Qdos. 

Compatability is improved now that 104 un-documented Z80 
opcodes have been implemented by emulator author William 
James. Dave Barker of Charvelsoft has extended QSPEC to load 
cassette files on any expanded QL, automatically adjusting its timing 
routines to match the system's ram speed. 

You can now save as well as load tapes through the QL NET port, 
and even headerless files and hyperloads are supported. Hackers 
will be pleased to hear that Z80 register values are available to 
SuperBasic, and the configurable disassembler can generate labels 
automatically. 

Dave Walkers Sectorkit allows QL programs to read and write 
data on Spectrum and One Per Desk microdrives, as well as 
obscure disk formats. A new conversion utility handles snapshot files 
from the fast PC emulator JPP, the Amiga Spectrum emulator, and 
the Spectrum's own Mirage Microdriver. All these are included on the 
720K Speculator 93 disk, together with complete 68000 source code 
for QSPEC, the emulator and disassembler. 

Meanwhile in the Netherlands Carlos Delhez has extended his 
shareware emulator Spectator to impersonate the 128K Spectrum, 
although this has not yet reached QL World. Ergon Development of 
Italy has demonstrated another emulator for 128K Spectrum 
programs, based on ZM/2 but extended to support the extra roms 
and 128K ram paging. | have tested the prototype, and find that it 
works, although the paging makes it slower than other Ergon 
emulators, For further information contact Ergon boss Davide 
Santachlara on 010 39 342 492323. 
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New developments 
jrom Ergon 


Ergon Development has introduced several new programs into 
their roster of QL utilities and 68000 Spectrum emulators. Following 
ZM/2, ZM/3 and ZM/hT (see Simon Goodwin's article in the March 
1993 QL World) there is now ZM/728, a Spectrum 48K/128K 
emulator which also implements Interface-1 emulation. The 
Supervisor is now similar to ZM/hT, with joystick emulation. ZM/128 
supports the new Z80 version 2 snapshot format, including utilities to 
convert 128K Disciple snapshot. 

Ergon’s benchmarks show that 128K emulation is a little slower 
than 48K emulation, but gives good speeds with the Gold Card. 
ZM/128 can be bought as part of the other emulator packages for 
an additional 20,000 Italian Lire (about £13). “ZM/x" (ZM/2 and ZM/3 
together) now costs 60,000 ITL, and ZM/hT now costs 90,000 ITL 
(plus post and packing, and the extra 20,000 ITL if ZM/128 is 
required). 

Ergon's Floppy Disk Utilities is a stand-alone program comprising 
a disk editor (Search, collect, recover, etc), disk copier/verifier (single 
and dual drives, with many features), and handles DD, HD and ED 
disks, as well as “alien” disks (PC, Spectrum, etc). FDU costs 35,000 
ITL plus post and packing. 

The DEA Intelligent Disassembler is now into version 5.10 Plus 2, 
with Qdos/SMS/Wman/Pointer Environment keys automatic 
remarking in the output code. System and Basic Variables keys are 
recognised. The price remains at 55,000 ITL plus P&P. 

Joining in the move towards cheap demo disks, Ergon issue a 
disk with over 1.5MB of compressed data, information, and public 
domain version demos of many of their programs. This is available 
on 3.5in disk for six International Reply Coupons. 

Ergon's post and packing charges for normal orders is 12,000 ITL 
(about £5) per order (not per item). For very large/bulky orders, please 
contact them for information. 

Davide Santachiara also notes that direct bank transfers can be 
made to Banca Popolare Dell'Emilia Romagna Italy, Swift BPMOIT22, 
(Telex 510031 emipop), Sede Reggio Emilia CC 6533/73 Davide 
Santachiara. This requires an extra 10,000 ITL added to the order, as 
this is what the bank charges Davide. 

All correspondence to Ergon Development, Davide 
Santachlara, Via Emillo De Marchi 2, 42100 Regglo Emilla, 
Italy. Phone +34 522 70409. 
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QL GOLD CARD 


£225 inc. (£200 outside EC) 


This is the expansion that has been revolutionising the QL. It is very easy to fit - 
it simply plugs into the expansion port at the left hand of the QL - and once fitted 
it will instantly increase the execution speed of the QL by about 4 times due to 
the presence of a 16MHz 68000 on board. There is 2M of fast 16 bit RAM of 
which QDOS sees a contiguous 1920K. The remainder is used for shadowing 
the QL’s ROM and display memory and for the GOLD CARD’s own code. 


There is a disk interface which can access 3 mechanisms (4 with the DISK 
ADAPTER) of 3 different densities, DD (double density, 720K), HD (high density, 
1.44M) and ED (extra high density, 3.2M) in any mix. The disk interface 
connector is the same type that was fitted to the TRUMP CARD so most QL 
compatible disk drives can be used. Please note that DD drives still give a 
capacity of 720K per diskette. Our DUAL ED DISK DRIVE allows the GOLD 
CARD to access DD, HD and ED diskettes. 


Another feature is the battery backed clock. When the QL is switched on the 
contents of the clock are copied into the QL’s clock so that the time and date are 
correct. The firmware in the ROM gives the GOLD CARD all the functionality of 
the TRUMP CARD like TOOLKIT II and there is a sub-directory system for 
floppy and RAM disks. 


Physically the GOLD CARD is about half the size of the TRUMP CARD and so 

fits almost all within the QL. Its current consumption is well under the allowable 

maximum so no special power supply is required. The GOLD CARD comes with 
a 14 day money back guarantee and a 2 year warranty. 


MIRACLE 


es 


The QxXL turns the common PC into a QL compatible. The package comprises a half 
card that plugs into an 8 or 16 bit standard ISA slot and a diskette loaded with a QDOS 
compatible operating system and a Superbasic compatible interpreter. After installation 

simply type QXL and the PC will appear to be a QL allowing QL programs to be run from 
QL format diskettes. 


The card itself has a 32 bit 68EC040 processor running at 20MHz which gives a good 
turn of speed. This processor has access to its own RAM and so performance is virtually 
independent of the host PC whether it has an 8088 or a Pentium. In fact the PC is used 
purely as an I/O system giving QL programs access to the PC’s floppy disc, hard disc, 
keyboard, display, serial and parallel ports. The card itself has QL style network ports to 
allow connection to a QL network. The minimum PC specification required is an XT with 
EGA display and a spare standard slot. 


Varying RAM sizes from 1M up to 8M can be supplied. The smaller capacities can be 
upgraded to the larger ones and the cost is simply the price difference. Not all the RAM 
is available to the user programs; the 1M equates roughly with a TRUMP CARD QL 
memory size and the 2M with a GOLD CARD QL. 


During the lifetime of the QXL we intend to enhance the software to make use of the new 
hardware facilities of the PC such as SVGA graphics. As has been our policy with the 
TRUMP CARD and GOLD CARD we intend to provide software upgrades free of charge. 


SYSTEMS 


QXL prices 
iM £295 (£255) 
2M £325 (£280) 


5M £410 (£355) 
8M £495 (£430) 


(prices in brackets for outside EC) 


QL SHOW SPONSORED BY MIRACLE 


INTERNATIONAL QL REPORT (IQLR) is a regular magazine that all QL 
users should read. It has articles for the beginner, the advanced user and 
every one else in between. Also, the international flavour combined with 
low advertising rates makes it probably the best place to locate QL related 
items. IQLR is run by QL enthusiasts whose proud boast is that they have 
never been late with an issue. If you do not already get it then ‘phone us 
now. One year’s subscription for 6 issues to any European address is 
£22.00 and it’s worth every penny. Subscribers 
elsewhere should contact SeaCoast Services, OIA 
15 Kilburn Court, Newport, RI 02840, U.S.A. direct. a 3 


Tel: (0904) 423986 | to: miracte sysTEMs Ltd, 25 Broughton Way, Osbaldwick, | 


To place an order by phone York, YO1 3BG, U.K. Tel: (0904) 423986 


I 
I 
I 
please have your credit card _{ Please send me 
. 1 
ready. For customers outside | | enclose a cheque to the value of: £ 
1 
I 


the EC = charge the prices Or debit credit card | 
shown in brackets. 


To order by post, please fill in Expires / 
the form opposite or writeto  ;Name_———~—SCSCSignaature 


number and expiry date, or 
enclosing a cheque payable to 
MIRACLE SYSTEMS Ltd. ee aa eee 


i 
us quoting your credit card Address 
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I 
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Very Basic 
SiperBasc 


Dilwyn Jones loops the LOOP in SuperBasic. 


in this third part of 


SuperBasic for new 
programmers, I'll be looking at 
looping structures. That's rather 
a big term to use at the 
beginning, so let's simplify it a 
little. 

A loop is a part of a program 
which performs a process over 
and over again - hence the 
name. Or, aS we Say, can be 
executed over and over again. 
This saves writing identical bits 
of a program several times to 
do the same job. 

The simplest type of loop is 
one which just goes blindly 
round and round, never 
stopping. This can be written 
using a REPEAT loop. REPEAT 
is a command which tells the 
computer to perform the 
following line or lines of Basci 
until told to stop. This is the 
simplest example: 


100 INPUT Enter your 
name:';n$ 

110 REPeat printing 

120 PRINT n$; 

130 END REPeat printing 


All that this does is ask you 
to enter a name, and then 
keeps printing it on the screen 
until you press BREAK (Ctrl and 
Space held down together) to 
stop the program. The part 
between REPEAT and END 
REPEAT is carried out well - 
repeatedly. Note that each 
REPEAT loop has a name (in 
this case “printing’). This name 
can be used as an ordinary 
variable and you can give it a 
value if you wish, though most 
people just use it to identify 


sun 


where the loop starts and ends. 
Names are very necessary, 
because you can have several 
loops one inside the other, a 
process called Nesting. 

If you think it is rather 
pointless not being able to 
stop the program in any other 
way, you'd be right! There is a 
keyword, EXIT, which can stop 
executing what's in the loop 
and jump out of it to carry on 
after the END  REPeat 
statement. EXIT is not much 
use by itself, but once we've 
discussed the IF..THEN clause, 
you'll see how useful it can be. 
REPEAT loops are generally 
used where a terminating 
condition is not known at the 
time of entry to the loop. 


FOR/END FOR 


The second type of loop is a 
FOR/END FOR loop. This 
allows us to make a program 
loop which is controlled by a 
variable which takes a preset 
value or range of values. The 
value of the variable is 
automatically altered each time 
the program goes round the 
loop. 

The start and end values are 
set at the start point of the loop. 


100 FORa=17TO3 
110 PRINT’ 
120 END FOR a 


This means that “a” is to 
have the values 1, 2 and 3. So 
the part between FOR and 
END FOR is executed three 
times, printing three asterisks. 
The program encounters the 
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FOR a statement and realises 
that it-must perform the part in 
the loop several times, starting 
off where a has the value of 1 
and keeping going until a has 
been 3. The first time, a is 1. An 
asterisk is printed. The program 
then runs into the END FOR 
statement, so it jumps back to 
the FOR a statement and 
works out the next value of a, 
which is 2. It checks that the 
loop has not reached the last 
value and prints another 
asterisk. Again, it jumps back 
from the END FOR to the FOR 
a statement and updates the 
value of a to 3, prints an 
asterisk and does the same 
thing again. But this time, the 
loop counter (as ‘a” is called) 
becomes 4, which is past the 
range specified, so the 
program now knows it has 
finished that loop and jumps to 
just after the END FOR 
statement. Since there is 
nothing there in this example, it 
realises it has finished the 
entire program and stops, 

In the example given, the 
variable “a” changes its value in 
steps of 1, which is what 
always happens if you don't 
specify a  value-change 
increment. 

The keyword STEP allows 
you to change this value. It can 
be a whole number, or a 
decimal fraction, positive or 
negative, so it is very flexible. 


100 FOR a=1TO6 STEP 2 

140) PRINT: 

120 END FOR a 

Here the value of “a” starts at 
1, the next time round it 
becomes 3, and_ finally 
becomes 5. Since the next 
value would be 7, and beyond 


the range specified, the loop 
would end when the value 
reached 7 (so only three 
asterisks would be printed in 
this case). 

lf you wanted to make the 
loop count backwards for 
some reason, you can do so by 
arranging the values in suitable 
order and using a step value 
which is» negative. This 
example prints an asterisk 
which appears to move from 
right to left across the screen 
by printing the asterisk in 
different positions, using a 
slight pause (PAUSE is a 
command which iells a 
program to wait for a given 
time, which is expressed in 
units of 1/50th second or 
1/60th second, depending on 
which model of QL designed 
for which country you have) to 
allow the symbol to be 
displayed for long enough to 
see before being wiped again 
by printing a space over it and 
printing it again in a different 
position to give the 
appearance of movement 
(albeit rather jerky movemeni). 


100 CLS 

110 FOR a =20 TO 1 STEP -1 
120 AT 5a: PRINT 

130 PAUSE 5 

140 AT 5a: PRINT ““ 

150 END FOR a 


There is still more we can do 
with FOR, Instead of just having 
one range of values, we can 
have a list of individual values 
and ranges, like this: 


100 FOR a = 1,2,4 TO 8 STEP 
2,15 TO 10 STEP -1,20 

110 AT 10,a: PRINT “™*” 

120 END FOR a 


In this case it executes the 
range of values between the 
commas one at a time, 
finishing one set before moving 
on to the next. Each range can 
have a STEP value if you want 
one. This is useful to place 
items in a list of positions. 
Normally, you'd find that most 
FOR loops are tidy and use just 
one range of values for most 
purposes, 

Nested loops (loops one 
inside another) are useful for 
creating lists or for printing in 
different directions, for instance, 
this little program prints a box 
of asterisks: 


100 FORy=17T010 

110 FORx=17T010 

120. ATyx 

130 PRINT” 

140 END FORx 

150. END FOR y 

In that example, the “y’ loop 
steps down the screen from 
one line down to 10 lines 
down. For each line, the “x” 
loop prints a row of 10 
asterisks across. 

There is another keyword 
called EXIT (which allows us to 
make a program jump out of a 
loop) which we should discuss 
here, but since we need to 
know about IF..THEN structures 
to make decisions so as to 
know when to leave a loop, 
we'll look at those first. 

Computers are good at 
making strict decisions in 
simple cases, no beating about 
the bush like humans! We 
might take a long time to make 
up our minds but computers 
can, if the information is 
available, make a quick and 
simple decision. An example of 
a human decision is to go out 
if it's nice weather, or decide to 
stay in when there is bad 
weather (ignoring silly people 
who seem to insist on climbing 
tall mountains in all weatherst). 

We might write this in Basic 
as something like: 


IF weather = fine THEN 
GO_OUT 

ELSE 

STAY_IN 

END IF 


In other words, the computer 
tests the condition after IF and 
if it works out to be true or 
valid, it executes the part of the 
program between IF and ELSE. 
If the weather was bad, it would 
be a false statement (a valid 
condition is normally referred to 
as TRUE and an invalid 
condition is usually referred to 


as FALSE) and would therefore 
execute the part between ELSE 
and END IF. 

So we can see that an IF 
clause can. provide two 
separate courses of action as a 
result of making a decision. In 
fact, it can be made to provide 
several courses of action by 
having more than one IF 
clause. 


100 x = RND(1 TO 2) 
110 IF x = 1 THEN 
120 PRINT’One” 
130 ELSE 

140 PRINT'Two" 
150 END IF 


That example showed a 
simple two case IF clause. 
Quite simple, because x is 
given a value of either 1 or 2 by 
the RND statement. It is 
possible to write more complex 
versions for more than one 
value: 


100 x = RND (1 TO 3) 
110 IF x = 1 THEN 
120 PRINT’One” 
130 ELSE 

140 IFx=2THEN 
150 = PRINT’Two” 
160 ELSE 

170. ~=PRINT’Three” 
180 ENDIF 

190 END IF 


| hope that last example is 
clear to you - basically it tests 
for two of the three possible 
values and if it is neither of 
these it must be the value 3. 
That example could be written 
in another form, which is 
shorter but which would not be 
good practice in large 
programs: 


100 x = RND(1 TO 3) 
110 IFx = 1 THEN 
PRINT"One” 

120 IF x = 2 THEN 
PRINT’Two” 

130 IF x = 3 THEN 
PRINT’Three” 


You will notice that there is 
no ELSE and no END IF in 
these clauses. This is where 
things get a little more 
complex! There are short form 
versions of IF, FOR and 
REPEAT loops just for when 
you want to do something in a 


single line. 
In this case, the action to be 
executed is placed 


immediately after the THEN 
keyword. If you want an ELSE 
statement as well, place a 
colon before it, like this: 


100 x = RND(1 TO 2) 


110 IF x = 1 THEN 
PRINT’One” ; ELSE 
PRINT’Two" 


The keyword THEN can 
usually be left out of an IF 
statement. This causes no 
problems in the long version, 
but in a short version if you try 
to enter something like IF x=2 
PRINT’Two" it gets refused as 
you try to type it in, the 
computer gives a “Bad Line’ 
report. You can get around this 
by putting a colon where the 
THEN would have been, so the 
statement would become IF 
x=2 : PRINT’Two” 

The colon is used. quite 
commonly to separate two or 


with multiple statements, it 
becomes really unclear and 
when. you: go back te look at it 
some time after you've written 
itt you may not even 
understand your own work if it's 
an untidy, badly laid out mess, 
so think tidy! 

In the short forms of FOR 
and REPEAT, the colon is 
essential. Here’s an example 
using FOR. 


100 FOR x = 1 TO 40: PRINT 


Note how much shorter this 
is than when written as one 
line containing a FOR 
statement, another containing a 


100 REMark Guess My Number 


110 CLS 


120 PRINT’Computer is thinking of a number.’ 
130 PRINT’which is from 1 to 100 (inclusive). ’ 
140 PRINT’Please try to guess it by entering’ 
150 PRINT’a number. you will be given clues’ 
160 PRINT’as to your accuracy.’ 


170 LET tries = 0 
180 LET number = 
190 REPeat program 

200 INPUT’Your guess 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 


IF guess = 


EXIT program 
ELSE 


320 EN 


330 END IF 
340 END REPeat program 


RND(1 TO 100) 


? ’;guess 

LET tries = tries + 1 

number THEN 
PRINT’Congratulations! It took ’; 
PRINT tries;’ tries.’ 


REMark it was not correct, so give clues 
IF guess < number THEN 

PRINT’Too low.’ 
ELSE 


PRINT’ Too high.’ 
D IF 


350 PRINT’Program Finished. ’ 


more commands on the same 
line. These are called, not 
surprisingly, “multiple 
statements”. Too much use of 
these can make a program 
difficult to follow when 
someone else tries to 
understand your program, but 
for short lines it is quite useful, 
especially where. related 
commands such as AT and 
PRINT are used together: 


100 AT 5,5 : PRINT “Hello” 


In these cases, it actually 
simplifies a program, but you 
must use it with care. When 
you start to write more complex 
programs, if you fill a program 


PRINT statement and another 
with the END FOR statement. 
Not only do we save having to 
write three lines of Basic, we 
can also leave out an END 
FOR statement, because once 
the computer reaches the end 
of the line, it automatically 
assumes that there is an END 
FOR statement there (you can 
include one if you wish, but as 
long as there is only one FOR 
statement on the line, it is not 
essential). 

We can also do the same 
with a REPEAT loop: 


100 REPEAT printing : 
PRINT"Hello “; 


u 
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Like a FOR loop, it does not 
require an END _ REPeat 
statement at the end of a line 
in this case. 

| mentioned the EXIT 
statement earlier. When used in 


170 END REPeat 
enter_numbers 


It is not quite so easy to 
explain the useage in a FOR 
loop, but | will try. It can be 


100 REMark Executive Decision Maker 


110 
120 
130 


CLS : PRINT’DECISION MAKER’ 
PRINT’ Think of a question and press ENTER.’ 
INPUT a$ : REMark a followed by dollar symbol 


140 PRINT’I have made the decision for you.’ 


150 
160 
170 


190 


conjunction with an IF 
statement it gives you the 
possibility of jumping out of a 
loop when a certain condition 
has been met, such as this 
little program which jumps out 
of a loop when the random 
number generated is a 6 


100 REPeat loop 

ie number = RND(1 TO 
10 

120 IF number = 6 THEN 
EXIT loop 

130 PRINT number 

140 END REPeat loop 


The program keeps going, 
printing the random numbers 
generated until it has thrown 
up a number 6, when it jumps 
out of the loop (jumps past the 
END REPeat statement), 

Using EXIT to jump out of a 
FOR loop is also allowed, 
though it is not used as often 
as it is in a REPEAT loop. An 
EXIT statement in a FOR loop 
will cause the program to jump 
to just beyond the END FOR 
statement. 

Finally, there is one more 
keyword associated with these 
loops, this is NEXT. This simply 
causes the program to go back 
to the statement which started 
the loop, allowing it to loop 
around from a different point if 
special circumstances dictate 
in your program. Its use is 
obvious in a REPeat loop, 
where it could be used to get 
around entering problem 
values for example: 


100 REPeat enter_numbers 
110 INPUT’Enter a positive 
number.”;number 

120 IF number < 0 THEN 
130 PRINT’Negative 
numbers not allowed.” 

140 NEXT enter_numbers 
150 ENDIF 

160 PRINT’OK’ : EXIT 
enter_numbers 


PRINT’My suggestion is:’; 
LET random_number = 
IF random_number = 1 : PRINT 
180 IF random_number = 2 : PRINT 
IF random_number = 3 : PRINT 


RND(1 TO 3) 

A ae 
‘NO’ 
"MAYBE ! ’ 


used to normally make the 
loop go round from one point, 
but there can be extra code 
between the NEXT statement 
and the END FOR to provide 
an ‘epilogue’ or a series of 
commands only executed if the 
entire loop has been 
successfully executed. In 
general, the action of NEXT is 
very similar to END FOR, but 
that an EXIT statement for 
example will always jump to 
the END FOR statement if it 
can find one. 


100 PRINT’Enter 6 numbers” 
110 FORa=1TO6 

120 INPUT number 

130 IF number = 0 THEN 
EXIT a 

140 NEXT a 

150 PRINT’Good, all 
numbers entered.” 

160 END FOR a 


Here, a loop is set up to 
enter six numbers. If you wish 
to stop the program after 
entering less than six numbers 
(for instance, if you realised 
you'd made a mistake and 
wanted to start again) simply 
enter a value of 0, which is a 
signal to the program to quit. If 
all goes well and you enter all 
six numbers, the program 
prints the message in line 160, 
but if-you enter 0, the program 
jumps out of the loop called ‘a’ 
and ignores the bit between 
NEXT and END FOR. You will 
be pleased to know that “loop 
epilogues” are not used that 
often, though it is useful to 
know of the technique in case 
you find it used in someone 
else's program! 


Examples 


After all that theory, let's type 
in a couple of short listings to 
put the theory into practice. 
First of all, a short game based 


on decisions. This is Guess My 
Number, one of the oldest 
games on a computer, but 
short and easy to understand. 

The computer generates a 
number at random from 1 to 
100 and invites you to 
guess what it was. You 
should type in a number 
from 1 to 100 when asked 
(remember to press Enter 
after the number). The 
computer will congratulate 
you if you get it right, or 
give you clues until you 
get it right. 

Figure two is another old 
favourite, the Executive 
Decision Maker. If you are 
feeling tired and stressed 
and can’t make your mind 
up, let this program do it for 
you! It gives a ‘yes’ or a ‘no’ or 
even an occasional ‘maybe’ for 
the really indecisive! 


Why not modify this program 
by adding a FOR loop around 
it to allow it to make more than 
one decision for you? Just 
don't blame me if you really do 
make decisions based on the 
dreaded QL random number 
generator! 

Figure three allows you to 


REMark Russian Roulette 
RANDOMISE 


test your luck by playing 
Russian Roulette! If you have 
luck like me, you will 
consistently find yourself dead. 
It shows how to use multiple IF 
statements to make a decision 
which can have more than one 
outcome. In this game the gun 
has six chambers. You fire it at 
yourself a given number of 
times depending on how lucky 
you feel! If the chamber is 
empty, you survive that shot 
and the gun just clicks, but if it 
bangs it contains a bullet and 
you are dead! This routine has 
IF statements all over the place 
and a FOR/NEXT/END FOR 
loop (a FOR loop with an 
epilogue as described above). 
It also adds a RANDOMISE 
statement which means that a 
new ‘base’ number for the 
random number generator is 
set, hopefully ensuring that they 
will be different each time! Note 
the use of the extra random 
number once the program has 
‘found’ the chamber with the 
bullet to give you a one in ten 
chance of surviving with a freak 
occurrence of a jammed gun 
(line 310). Note how the FOR 
loop counter value (the value of 
the variable “x”) is used to 
choose a comment for the shot 
number. 


CLS : PRINT’The gun has 6 chambers.’ 
PRINT’One contains a bullet.’ 

PRINT’How many times would you like to’ 
INPUT’risk your life ? ’;shots 


CLS 
LET bullet = RND(1 TO 6) 


LET random_number = RND(1 TO 6) 


FOR x = 1 TO shots 


PRINT’Shot ’;x;’. Press ENTER.’ 


1 | 
OmnFP wry 


: PRINT’The tension is high...’ 

: PRINT’Getting risky...’ 

: PRINT’Surely this time...’ 

: PRINT’No chance...’ 

: PRINT’You must be plain lucky...’ 

: PRINT"You can’t survive the sixth shot..." 


LET random_number = random_number + 1 


IF random_number 


7 THEN LET random_number = 1 


IF random_number = bullet THEN 
IF RND(1 TO 10) = 1 THEN 
PRINT’How lucky can you get!’ 
PRINT’That chamber held the bullet,’ 
a the gun jammed.’ 


PRINT"BANG! You’re dead! R.I.P." 
EXIT x 


END IF 


ELSE 
PRINT’CLICK. You survived that one!’ 
END IF 


PRINT 
NEXT x 
PRINT ‘Good grief, you survived all ’;shots;’ shots!’ 
50 END FOR x ; 


440 
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RELEASE_TASK 
tasknum, tasktag 
[Turbo Toolkit] 


REMark 


REMOVE_TASK 
tasknum, tasktag 
REMOVE_TASK -1 


THE 
NEW 


USER GUIDE 


KEYWORD INDEX 


This month in the Keyword Index, Mike Lloyd 
opts to RELEASE_TASK, but in the end he 
must once more RETURN. 


TASK MANAGEMENT COMMAND 
tasknum An integer, part of the unique reference for a task 
tasktag An integer, part of the unique reference for a task 


The RELEASE_TASK command is very easy to confuse with its REMOVE_TASK cousin, but they have 
almost opposite effects. “Release” is used in the sense of releasing from bondage, in this case the bonds of 
sleep imposed by the SUSPEND_TASK command. SUSPEND_TASK places a task into hibemation, usually 
for a set period of time. Should you need to resurrect the task earlier than expected, a RELEASE_TASK 
command must be executed in some other running task. If the task has already been awakened, the 
RELEASE_TASK instruction is ignored. Incidentally, the two parameters uniquely identify the task in question: 
SuperBasic has the special value of 0,0 but the references for other tasks cannot be predicted. For obvious 
reasons, a task cannot awake itself. See the LIST_.TASKS Turbo Toolkit procedure for details of how to 
determine which identifiers go with which tasks. 


PROGRAM COMMENTING DIRECTIVE 


REMark is not strictly a command but a placeholder for a command. No matter what follows a REMark 
keyword on a line, it is ignored by the interpreter. This provides an opportunity to add meaningful comments 
to programs (hence its name) or the means temporarily to prevent some commands from being executed. 


TASK MANAGEMENT COMMAND 
tasknum An integer, part of the unique reference for a task 
tasktag An integer, part of the unique reference for a task 


The REMOVE_TASK command kills off any job, whether dormant or active, and removes it from memory, 
releasing any allocated memory as it does so. The one task impervious to its effects is SuperBasic. Tasks 
can kill themselves off if a single parameter of -1 is used. This is in contrast to most task-related commands 
that assume that the current task is meant if no parameters at all are provided. Whether deliberate or not, 
the requirement to include a parameter here should concentrate the programmers mind and ensure that 
no mistakes are made. 
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RENAME oldname TO 
newname 


RENAME oldname, newname 


[Super Toolkit II] 


FILE MANAGEMENT COMMAND 
oldname The name of an existing file 
newname The name the existing file will be given 


In SuperBasic the process of renaming a file has two steps: copying the file to provide the new 
name and deleting its predecessor to remove the old. Super Toolkit Il combines these steps into 
one command. As with most of SuperBasic syntax, the TO keyword and the comma are entirely 
interchangeable. The SuperToolkit Il manual may be slightly misleading in suggesting that all of 
the COPY options are available with RENAME. In fact, renaming a file with a name that already 
exists simply produces an “Already exists’ message rather than an option to overwrite. RENAME 
has no equivalents to the COPY_O, COPY_H and COPY_N variants (nor does it need them). 
Neither does RENAME acknowledge the existence of an implicit destination directory, as set with 
DEST_USE. Nevertheless, RENAME is a valuable short-cut for the basic task of providing your files 
with new titles. 


RENUM start TO end; newstart, step 


RENUM 

RENUM start 

RENUM TO end 

RENUM start TO end 
RENUM start TO end, step 
[Improved by Minerval 


REPeat control 
<commands> 


A) 


LY 


PROGRAMMING UTILITY 


start (Optional) A positive integer representing the start of a line sequence 

end (Optional) A positive integer representing the end of a line sequence 

step (Optional) A positive integer representing the amount by which lines are 
incremented 

newstart (Optional) A positive integer representing a new start for a line sequence 


The RENUM command renumbers the lines of SuperBasic programs. By default, line numbers 
begin at 100 and are incremented in steps of 10, but deletions and insertions soon spoil this 
orderly sequence. RENUM allows the programmer to restore order to his or her line numbering 
without explicitly changing each line by hand. Sinclair never seemed to finish debugging the 
RENUM command and for those that find its idiosyncrasies annoying the Minerva upgrade is 
thoroughly recommended. 

With the Minerva rom fitted, the RENUM command is incredibly flexible about its parameters. 
Unusually for SuperBasic, the RENUM syntax distinguishes between TO and a comma. In 
essence, the syntactical rules are as follows: 


if they appear at all, parameters must appear in the order shown in the full command syntax 
above. 

a number immediately following the RENUM command is taken to be the start number of a 
sequence of lines 

a number following a TO is taken to be the end number of a line sequence. 

a number following a comma indicates the amount by which line numbers are to be 
incremented. 

a number following a semicolon is used as the new start number for the given line sequence. 


RENUM with no parameters changes all the line numbers in a program so that they once again 
follow the rules of beginning at 100 and increasing by 10 at a time. RENUM followed by a single 
number renumbers all lines beginning with that number in increments of 10. RENUM , 5 
renumbers all lines with an increment of 5. RENUM ;500, 20 renumbers an entire program so that 
it begins at line 500 and each line is numbered 20 higher than its predecessor. The permutations 
offered are far too many to include here, but many of them will not work with a standard QL rom. 
RENUM will successfully renumber all constant line references in RESTORE, GOTO and GOSUB 
commands. However, RENUM cannot renumber lines in a way that changes the sequence in 
which they occur. Any attempt to do so will result in an “Out of range” error. 

The QL User Guide states flatly that RENUM should not be used in a program. This advice can 
safely be ignored provided that the RENUM does not renumber the line on which it itself appears: 
include it in a procedure with very high line numbers and always include a TO value to stop 
renumbering before the procedure is reached. Alternatively, variables can be assigned to 
represent start and end values and the RENUM command can be attached to a hotkey (see 
ALTKEY in this guide for details). 
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EXIT control 
<commands> 
END REPeat control 


REPeat control: <commands> 


RESPR(memory-size) 
[Modified by Minerval 


RESTORE line 


LOW-LEVEL PROGRAMMING STRUCTURE 
control A numeric variable of indeterminate value used to control and identify the loop 
EXIT control An optional clause 


The REPeat structure is perhaps the simplest and the easiest to use of all of the SuperBasic 
programming structures. It is a valuable alternative to more traditional FOR..NEXT loop because it does 
not impose a limit to the number of times a loop is executed. Unlike a FOR..NEXT loop the controlling 
variable of a REPeat loop cannot be accessed from within the program. It does not, for instance, reveal 
how many times the interpreter has travelled around the loop (although this would be very useful 
information: Minerva developers please note’). 

By default, once the interpreter is caught inside a REPeat loop it is locked in there forever. This can be 
ideal for controlling games, and so on, but there are many instances where life must go on. The EXIT 
clause provides a means of escape, either within an IF clause or as part of a SELect structure. Here is a 
typical, but completely useless, REPeat loop: 


100 REPeat loop 

110 x = RND(40) 

120 IF x = 12: EXIT loop 
130 END REPeat loop 


Incidentally, the overwhelming aptness of the variable name “loop” in these circumstances has lead 
programmers into thinking that “loop” is itself a keyword and perhaps the only permitted name for a 
REPeat controller. 

As with most SuperBasic structures, REPeat supports a short form in which the REPeat statement and 
the statements to which it pertains are all contained on one line of a program. The short form allows 
programmers to leave out the END REPeat statement 

REPeat structures can be nested along with other low-level constructs such as IF.THEN.ENDIFs, 
FOR.NEXTs and SELECTs. From deep within the nesting an EXIT command canying the name of the 
outermost structure will quickly extricate the interpreter and send it on its way, but some purists prefer to 
jump out of the nest one layer at a time. That is entirely up to them, but seems like a waste of time to me. 


MEMORY MANAGEMENT FUNCTION 
memory_size An integer representing a number of bytes of RAM. 


RESPR is the function that fences off areas of the QL’s memory so that it can be used exclusively by one 
program. The parameter it requires indicates how much memory should be reserved, but this is rounded 
to the next highest 16 bytes. The value returned by the function should be carefully retained in a variable 
as it is the start address of the roped-off memory. This address will always be divisible by 16. 

The most frequent use of RESPR is to allocate memory into which can be stored the code relating to an 
extension of SuperBasic (ie the code that adds a new command to the language). However, reserved 
memory can be used for all sorts of data storage. For instance, reserved memory can be used instead of 
arrays, in which case sorting is achieved by shunting blocks of bytes up and down the QL’s memory. 

On standard QLs RESPR cannot be used if jobs other than SuperBasic are running. This restriction is 
overcome by Minerva. 


DATA MANAGEMENT COMMAND 
line (Optional) A valid line number (that must exist in Turbocharged code) 


The great majority of Basic dialects allow data to be embedded in programs in DATA statements. 
Whenever a READ statement is encountered then the next available DATA item is allocated to the 
variable referenced in the READ statement. Sometimes it is desirable to go back over data and use it 
again. Sometimes it is necessary to go to a block of DATA items while some earlier DATA statements 
remain unread. Both circumstances are catered for by the RESTORE command. 

RESTORE on its own sets the data pointer back to the first item in the first DATA statement in the 
program. RESTORE followed by a line number puts the data pointer onto the first item in the next DATA 
statement on or after that line. When preparing programs for compiling with Turbo there is the slight 
disadvantage that the line number given must contain a DATA statement. 

When you RUN a program the data pointer is not disturbed, therefore it is often a good idea to have a 
RESTORE command somewhere near the start of a program. 
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RETRY 


RETRY_HERE 
[Turbo Toolkit] 


RETURN 
RETURN expression 


> 


WV. 


PROGRAM HANDLING COMMAND 


A SuperBasic program can halt because an error has been generated, or because the user 
pressed Ctrl-Space, or because a STOP statement has been encountered or because the 
interpreter has executed the last line of a program. In such circumstances the user can enter 
CONTINUE or RETRY to revive the program. Whereas CONTINUE sends the interpreter on its way 
from the line following that on which it stopped, RETRY forces the interpreter back for another go at 
the line it stopped on. This can be an advantage if the problem was, for instance, a printer that was 
not on line or a variable that was not holding the right value. The mistake can be put right and 
RETRY used to repeat the line that fell over. The QL User Guide indicates that you should not edit 
the program during a pause of this nature but you can often get away with it, particularly if any 
changes affect only the lines higher than the one on which the program stopped. 


ERROR HANDLING DIRECTIVE 


When SuperBasic program code is compiled by Turbo the concept of line numbers is much less 
strong, with the result that there is no immediate support for a simple RETRY command within an 
error-handling procedure (controlled by WHEN_ERROR, detailed later in this manual). Turbo keeps 
no track of the current line and statement, nor the state of certain key Qdos tables, at the end of 


“each executed statement just in case an error occurs. Because of this, it doesn't know if it is safe to 


go back to a particular line when directed to do so from within an error-handling code block. 
Instead, the Turbo Toolkit includes the RETRY_HERE directive. This can be included anywhere 
deemed sensible in the program and as many times as might be required. When an error is 
detected and handled by a WHEN_ERROR routine containing a RETRY command the program will 
retum to the last-encountered RETRY_HERE command and continue on its way. It is assumed that 
the WHEN_ERROR procedure has the intelligence to correct the circumstances of the error, 
otherwise it is very easy to cycle round small pieces of flawed programs forever. 


HIGH-LEVEL STRUCTURE DIRECTIVE 
expression (Only in function definitions) A value of the type indicated by the name of the 
function 


Functions take values called parameters, work on them for a bit and retum a value. User-defined 
functions return the final value using a RETURN statement followed by a value, either a constant or 
a variable. The value returned must be compatible with the name of the function, so a function 
name ending in a dollar sign will return a string and one without will return a numeric value. The 
normal rules of coercion can apply, but only at the-expense of time and with the increased 
prospect of human error. 

The following example function is passed a single, numeric parameter. It returns a string indicating 
whether the parameter is greater than, less than, or equal to zero: 


500 DEFine FuNction what_value$ (number) 
510 SELect ON number 

520 ON number < 0 

530 answer$ = “Less than Zero" 
540 ON number = 0 

550 answer$ = “Equal to Zero” 
560 ON number > 0 

570 answer$ = “Greater than Zero" 
580 END SELect 

590 RETURN answer$ 

600 END DEFine what_value$ 


In a user-defined procedure RETURN can also be used, but it must not have a value following it. Its 
main appeal is that an early escape from the procedure can be engineered from within an IF 
statement along the lines of IF x < 12 THEN RETURN. When debugging programs early RETURNs 
can be used in effect to comment out large chunks of user definitions. 
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HARDWARE 


Care Electronics 

0923 672102 

Tebby connection but no longer dealing 
directly. 


CL Systems 
081 459 1351 
Real Time Digitizer 


Computer Technik 

(Jurgen Falkenburg) 

010 49 7231 81058 

(Germany) 

Hard disk interface, hard disk systems, 
tower housings for QL systems. 


Dilwyn Jones Computing 
(DUC) 

0248 354023 

Process controller, Power regularot, 
network prover. 


Miracle Systems 

0904 423986 

Gold Card expansion card; disk adapter, 
Extra High Density disk drives; Centronics 
adapter/lead; ED disks. 


Qubbesoft PD 

0376 347852 

Miracle Trump Card, Expanderam, twin 
3.5in disk drives. Sales and support. 


W N Richardson (EEC) 

0753 888866 

Complete QL systems, monitors, 
keyboards and interfaces, disk drives and 
printers, peripherals. 


TF Services 

071 724 9053 

Hermes IPC, Minerva rom, keyboard 
membrane, repairs, spares, 


SERVICES 


Adman Services 

(Dennis Briggs) 

0952 255895 

Spares, repairs, support, peripherals. 


Joe Atkinson 
36 Ranelagh Rd., London W5 5RJ 
Roms, mdvs, all spares. 


Suredata 
081 902 5218 
Repairs 


QL World 

(Readers’ Services) 

Subscriptions, binders, recent backissues, 
0993 811181 

Ask for Fran. 


Quanta 

General Secretary: 

Ron Dunnett 

0376 347852 

User group, support, library. 


SOFTWARE 


Athene Consultants 
0705 511439 


ARK Distribution 
0983 79496 
Archivist, Master Spy, Spy. 


CGH Services 

(Richard Alexander) 

0559384 574 

Adventures, public domain, DIY Toolkit. 
(Closing for business 31 March 1993 - 
enquiries about past products only,) 


COWO Electronic 

010 41 45 211478 

(Switzerland) 

QTop, Atari QL emulator, Thor support 


Deltasoft 
7 Tyrell Way, Stoke Gifford, Bristol. 
FlightDeck, Image D, AMD Airplan 


Digital Precision 

081 527 5493 

Perfection, PC Conqueror, Lightning, 
Professional Publisher, Eye-Q, Solution, 
Spellchecker, The Editor, Media Manager, 
Professional Astrologer, QMaths, CPort, and 
others. 


DJW Software 
0256 881701 
Homebanker 


Dliwyn Jones Computing 

(DUC) 

0248 354023 

Discover, Textidy, QL-PC Fileserver, Fleet 
Tactical Command, Basic Reporter, 
QLiberator, Filemaster, The Gopher, The 
Painter, Flashback, DataDesign, QPAC2 and 
other Pointer Environment programs, others. 


Di-Ren 

081 291 3751 

Fleet Tactical Command 
(Dist. by Dilwyn Jones) 


Ergon Developments 
(Davide Santachiara) 
010 39 342 492323 


(Italy) 


ZM-X ZX Spectrum emulator, Open World, 
other QL sofware. 


Jochen Merz Software 

010 49 203501274 

(Germany) 

QL/Atari emulators, QSpread, File Finder, 
QPTR Pointer Environment Toolkit and 
other PE programs, QDesign 2, various 
games, and others. 


Lear Data Systems 

6 Southview Green, Bentley, lpswich, 
SUffolk IPQ 2DR. 

PCB-CAD 


Liberation Software 

081 546 7795 

QLib Basic compiler and utilities. 
(Dist. by Dilwyn Jones) 


Pointer Products 
0258 455117 
Pointer Environment programs 


Progs (Van Auwera) 

010 32 16 48 8952 

(Belgium) 

The Painter, The Clipart, DataDesign, 
QRactal, and others 

(Dist. by Dilwyn Jones) 


Qubbesoft PD 

0376 347852 

QL Home Finance, Public Domain 
software. 


SD Microsystems 

0462 422897 

General Ledger, Small Traders’ 
Pack/Invoicer and Stock Accounting. 
Other business software. 


SJPD Software 
0282 51854 
Public Domain software 


Software 87 
33 Savernake Road, London NW3 2JU. 
Text87 Plus4 


TF Services 

071 724 9053 

Qualsoft QL Terminal Emulator, File 
Transfer, 


WD Software 
0534 81392 


Notes: 

Addresses are only given where there is 
no business line. For Fax numbers, 
phone dealer or check ad. in QL World. 
Only larger dealers have Fax, often on 
the same number. Some numbers no 
longer active in the QL world are given 
for reference and support queries. 


SERMouse 


Bryan Davies scuttles through three versions of an 
adaptable QL mouse package. 


Programs witen wih a 
mouse in mind can be awkward 
to use without one. This is very 
evident with those programs 
which use the QJump Pointer 
Environment. While it is possible 
to access the normal 
commands’ through the 
keyboard, it can be rather long- 
winded to do so. It is both 
regrettable and surprising that 
the QL has never benefited from 
a “standard mouse”. There has 
been the Ice mouse, the ABC 
one, the Smiling Mouse, the 
Sandy mouse, the Qimi mouse, 
and various others. The Ice one 
worked well, but was limited to 
Eidersoft's programs, the ABC 
had a variety of mechanical and 
software problems, the Smiling 
Mouse showed promise which 
was ruined by software that was 
never finished and marketing 
that left various people 
disappointed. The Qimi mouse 
(and interface) should, perhaps, 
have been “the one’, coming, as 
it originally did, from the 
producers of QRam and QPac; 
the Qimi interface is now 
available again from the Quanta 
users’ group, some problems 
having apparently been sorted 
out. 

SERMouse is a software 
mouse driver from Albin Hessler 
Software (in Germany) that is 
presumably intended to fill the 
gap the Qimi interface left when 
it originally went off the market. It 
is clearly designed to work with 
the Pointer Environment. One 
big merit is that standard mice 
from other computers can be 
used with it. The instructions do 
not specify particular brands 
and models of mouse that are 
safe to attach to the QL, but both 
the UK suppliers (W N 
Richardson and Software 87) are 
shipping a mouse and 
connecting cable with the 
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software, relieving the buyer of a 
few problems. 


Variables 


To avoid confusion, it should 
be explained before going any 
further that the iterns received for 
review came from different 
sources, and the review was 
done in three stages: 


1) Connecting a standard PC- 
type mouse to the QL. This 
involved reading the SERMouse 
instructions and soldering two 
connectors to a cable, to make 
an adapter cable to go between 
mouse connector and Serial 
port connector. 


2) Using the mouse software 
supplied by Software87 (with 
update from Albin Hessler), and 
the mouse and adapter cable 
as mentioned in 1). Note that 
Software87 normally supply a 
complete kit - mouse, adapter 
cable and software - and the 
information given below on 
making adapters for a mouse is 
for the benefit of anyone buying 
the software on its own (eg 


‘direct from Albin Hessler 


Software). The mouse referred to 
here is a standard PC type, with 
three buttons, connected to the 
serial port by cable. 


3) Using a kit comprising 
mouse, adapter cable, mouse 
software, and drawing software, 
supplied by W N Richardson. 
The mouse referred to here is 
an infra-red type, which has no 
cable itself but transmits to a 
receiver unit connected to the 
QL through its cable and an 
adapter. The same supplier 
offers a kit with standard, cabled 
mouse for £10 less than the 
infra-red version; it is assumed 
the standard kit should be 
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essentially the same as that 
offered by Software87. 


Connecting a 


standard mouse 


Many users would not feel 
like chancing their money and 
QL by plugging in any old 
mouse. The decision on what 
mouse to use was made easier 
by the information from 
Software87 (and in the 
SERMouse instructions) that a 
standard 3-button PC mouse - 
such as the Genius GM-6 
which | happened to have 
spare - would work. 2-button PC 
mice also should work, 
although mice that perform 
auto-sensing to switch between 
Microsoft (2-button) and Mouse 
Systems (8-button) modes may 
not work. Potential buyers of the 
complete package need not 
concern themselves with some 
of the following comments, as 
the latter are made for those 
who intend to find their own 
mouse and cable. 

A note of caution in the 
SERMouse instructions was a 
bit worrying - mice require 5 
volts DC, but the QL serial ports 
only supply at 12 volts. It is 
stated that the load of a mouse 
will drop the 12V down to SV, 
making the supply safe for use 
with mice. Certainly, the voltage 
from the serial port checked 
dropped to about 5.5 when only 
a mouse was connected, and 
the mouse behaved without 
tantrums. When a printer is 
connected to the other port by 
a direct serial connection, there 
is no additional load on the 
supply and there should be no 
trouble with mouse function but, 
when a Serial-parallel converter 
is used - aS one commonly is 
on QL systems, because 
printers normally have parallel 
interfaces - the combined load 
on the 12V supply is likely to be 
too great for correct operation 
(of either device). 


Loading fix 

The suggested course of 
action to get around this 
difficulty is to fit an individual 680 
ohm resistor to pin 6 on each 
serial port, from the +12V line on 
the motherboard. One such 
resistor is fitted as standard, but 
to both ports together. The 
instructions on this point were 
not clear enough to make one 
happy, and average users would 
not want to tamper with the QL 
internally. Effectively, this 
reservation appears to rule out 
this form of mouse interface 
(with either standard or infra-red 
mouse, presumably) for many 
users, which is a pity. However, it 
is stated that the mouse or a 
printer serial-parallel link can be 
used separately without 
problem, so the user has the 
(inconvenient) option of 
unplugging one or the other. It is 
made clear that 12V should not 
be applied directly to the mouse, 
presumably meaning that a 
stronger 12V supply than that in 
the QL could feed the mouse 
with well over the specified 5V 
and, thereby, make it roll over. 
The last section in the 
instructions, headed 
“Guarantee”, basically says “be it 
upon your own head”, and one 
cannot blame the program writer 
for that. It is not his fault that 
interface wiring is a bit of a 
minefield. The user with 
reasonable DIY capability need 
not be put off by this; a standard 
QL and PC mouse should work 
together, using a cable wired to 
one of the four given 
configurations (my own set-up 
uses the one for the 6- 
connection 25-pin D mouse and 
9-pin D SER2 port). 

Another big- plus-point for 
SERMouse is that no form of 
interface board has to be 
attached to, or inserted into, the 
QL When the full kit is bought, 
all the user has to do with the 
hardware is plug it in, but it is 
important to advise your supplier 


of the type of SER connector on 
the QL concerned. For the DIY 
purchaser (of the software 
alone), you first have to find a 
way of linking your mouse to 
your QL, and that is not as 
straightforward as one would 
like it to be. This is not the 
program-writer’s fault, though. 
The instructions provide four 
tables, covering eight possible 
cable configurations. This is not 
as bad as it may sound, since 
the configurations split into 
groups which can all be 
identified easily - except one. It 
is obvious whether your QL has 
9-pin D-shaped connectors or 6- 
pin PCC ("telephone") sockets 
for SER1 and SER2. Equally, the 
number of pins on the D mouse 
connector - 9 or 25 - will be 
clear. You are free to use SER1 
or SER2 (remember that they are 
wired differently), and the 


MOUSE D25 M 
CONNECTOR PIN: 
2 


3 
4 
ih 


Y) 


MOUSE D9 M 
CONNECTOR PIN: 


decision on which one to use 
will probably be made for you by 
the fact that a printer is 
connected to SER1. SERMouse 
comes configured for SER2, 
which makes good sense. 


Wiring groups 
What may not be so easy is 
determining which of the two 


wiring groups listed applies to 
your mouse; the tables (see 
box) show 9- and 25-pin mouse 
connectors using only 4 of 
those pins each, but they also 
show a variant of 9-pin 
connector with 5 pins used and 
a 25-pin variant with 6 pins 
used. Fortunately for me, | had 
long ago checked the serial 
port wiring on both my UK and 
US QLs (PCC and D connectors, 
respectively), making it relatively 
easy to make-up a Suitable 
cable for the US QL normally 
used for my reviews. You may 
be able to get a ready-made 
cable (try TF Services), but you 
will still have to specify the 
wiring configuration required. 
There is always a question 
mark when one has been 
wielding the soldering iron, but 
things went fine with this job, 
and the mouse worked properly 


QL D9 M 
SER2: 


QL SIGNAL: SER1: 
TxD 3 
RxD 2 
+12V 9 
GROUND 7 


GROUND 
TxD 
RxD 
GROUND 
GROUND 
+12V 


QL D9 M 
SER2: 


QL SIGNAL: SER1: 
TxD 2 
RxD 3 
GROUND ‘4 
+12V 9 


with the first Pointer program 
tested (QSpread). When one has 
used Abacus, a program like 
QSpread feels cumbersome if 
only the keyboard is available; 
the presence of the mouse 
made it much nicer to user, a 
two-handed technique being 
desirable to do the necessary 
PE manipulation and the data 
entry. 


With serial ports 


The pin connections given 
here are for the connectors at 
the ends of the linking cable. 
“D9” indicates a 9-pin D-shaped 
connector, as used on German- 
and US-market QLs and on 
current PC (“PS/2") mice. “PCC6” 
indicates the 6-pin telephone- 
style plugs and sockets used on 
Uk-market QLs. “D25" indicates 
the standard RS232 connector 
used on PCs and mice until 
recently. “M’ and “F” indicate 
Male and Female, respectively. 
See table one. 


e 
Using the mouse 
Mouse-pointer movement 


- across the screen is smooth, 


and response to the buttons is 
clean. Movement from side to 
side of the screen required less 
than half of the width of a 


QL PCC6 M 
SER1:. SER2: 
2 3 2 


3 2 3 
9 6 6 
i 1 1 


QL PCC6 M 
SER1: SER2: 
3 2 3 


2 3 2 
it 1 1 
9 6 6 


normal mouse mat, which is 
quite reasonable. The resolution 
can be decreased, thereby 
decreasing the movement 
required, with the supplied 
configuration utilities. 

The mouse functions with 
non-PE programs, with or 


without the PE itself being 
loaded, but the behaviour is 
rather uncertain and is more a 
curiosity than a useful feature. 
The fact that these programs - 
for example, Files 2 (from 
TaskMaster) and Quill - respond 
at all to the mouse suggests 
that it would be possible to 
make them properly “mouse 
aware”. This raises a prospect 
that is definitely interesting, as 
there must be many QL users 
who would like to have just one 
mouse, that could be used to 
control most, if not all, of their 
favourite programs. 

Whatever the current level of 
attention to the Pointer 
Environment, it is not at all likely 
that it will become universally- 
used within the QL community, 
and it is desirable that 
SERMouse be made to work 
with existing non-PE programs. 
Clearly, Psion are not likely 
to develop their Quartet to 
use the mouse, but it is not 
beyond the bounds of 
possibility that someone 
else might introduce the 
necessary links into these 
programs, rather in the 
manner that Turboquill 
made the latter program so 
much more usable some 
years back. 


Instructions 


The SERMouse 
instructions run to 13 AS 
sides, with a further four 
sides on SuperBasic 
extensions on the supplied 
disk (which do not relate 
directly to the mouse). The 
supplied 3.5-inch DD disk 
contained 22 files (half of 
them duplicates), which 
were in the bi-lingual 
format that seems normal 
with German PE-based 
programs. An example 
Boot routine is supplied, 
and this makes it fairly 
obvious what order to put 
the various vital ingredients 
of your own system Boot 
routine in. The only file 
which is actually essential 
is SERMouse itself, and 
that has to be loaded with 
the LRESPR or RESPR 
command, after PTR_GEN, 
WMAN and HOT_REXT, if they 
are in your Boot (they are not 
supplied on the disk). You are 
advised on how to create a 
usable version of SERMouse, 
but the supplied one worked 
without any need for 
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configuration, in the review 
system. When the PE files are 
not present, SERMouse works in 
“cursor mode’, mouse 
movements being translated 
into cursor-key presses, 

All. this might seem 
unnecessary, when all you have 
to do is copy one file onto your 
Boot disk and put a load 
command for it into your Boot 
file. The rest deals with the 
various configuration 
parameters/commands. One 
thing about the QL that seems 
to bug programmers is the 
inability to set different Baud 
values (data-transfer rates) for 
the two serial ports. As 
SERMouse works at 1200 Baud, 
and most people will be using 
their printers at 9600 Baud, there 
is potential for conflict, but the 
mouse driver avoids this by 
setting the rate for both ports to 
1200 initially, then suspending 
the mouse input and resetting 
the rate for the other port to its 
normal value, if a program 
requests a channel for output to 
a printer. The mouse input is 
then automatically re-connected 
when the print has finished. You 
can have printer and mouse 
active together, but at the 
expense of turning the printer 
data rate down to 1200 Baud. 
So, you do not do much 
mousing on a day when there is 
a heavy printing load. The 
Hermes replacement for the 
8049 chip is stated to be 
compatible with SERmouse, 
allowing the two ports to run at 
different rates with no need for 
“operator intervention’, 


There is a rather more 
annoying bodge required if you 
use Psion programs, as they 
apparently do not automatically 
close channels opened for 
printing. You have to “manually” - 
that is, through SuperBasic- set 
the Baud value to 1200 to get 
the mouse going, or 9600 for 
print from the programs. 

The remainder of the 
instruction booklet deals with 
configuration of SERMouse, 
using the standard PE Config 
routine, and explanations of the 
SuperBasic commands which 
can be used. separately to alter 
the parameters. You can change 
just about anything - Baud, port, 
pointer and cursor speeds, 
acceleration factor, double-click 
delay, etc. A screen-blanking 
function is incorporated, with a 
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range of 0-20 minutes, with a 5- 
minute default. There is a 
detailed list of button-press 
combinations and their effects. 


Infra-red mouse 


The kit comes in a smart box, 
nicely presented but rather 
daunting. It appears to be 
designed primarily for PC users, 
with items needed by QL users 
added on. The mouse had the 
usual three buttons on top, plus 
an additional one on the left 
side; at the front was the “eye”. 
Four disks were for use with PCs 
- no use for the free game, for 
which there was a substantial 
instruction book! The remaining 
3.5-inch disk was the 
SERMouse_ software. The 
mouse-driver file was version 
1.04, whereas 2.07 was supplied 
for testing the standard mouse; 
both versions were used when 
testing the infra-red mouse, and 
there was no_ apparent 
difference in behaviour, but it is 
to be hoped the later version 
and its (better) instructions will 
now be supplied with the kit 
mentioned here (which has 
been in circulation for some 
time). The 25-to-9 pin adapter 
that usually comes with PC mice 
was replaced by a 25-6 pin 
(PCC) adapter for the QL The 
SERMouse instructions implied 
that SER2 was the expected 
connection, so that socket was 
used. 

The instructions were similar 
to those provided by Software87, 
but less detailed. It was not clear 
what had to be done to get the 
software installed, although all 
that was required was to copy 
one file onto my system boot 
disk and add one line to the 
boot. It would not be obvious to 
some purchasers which file to 
copy and how to add the boot 
file line, and there were two 
driver files to choose from, 
neither of them mentioned in the 
instructions. The first of the files 
was tried and it worked: the 
other one was not tried. 


Fitting 

The mouse had its own 
instruction book, which was 
quite sufficient for the little work 
that was required. After the 
adapter had been fitted to SER2 
and the infra-red receiver 
connector plugged into it, two 
AAA batteries (supplied for the 
review) had to be fitted into the 
mouse, a button on the side 
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then needed pressing, and the 
mouse was up and running. 
Leastways, it did what was 
expected of it when used with 
Jochen Merz's HyperHELP 
program. 

From there on, behaviour was 
the same as with a standard 
mouse. TO conserve the 
batteries, the infra-red mouse 
goes into “stand-by” mode after 
the mouse has not been moved 
for 5 seconds, and it switches off 
automatically after 20 minutes 
without use; the extra button (on 
the left side) is used to re- 
activate it. Presumably, then, you 


can leave the mouse for fairly 


long periods without the 
batteries going flat. The 
instructions state that the range 
of infra-red transmission is five 
feet, within an angle of 45 
degrees either side of the direct 
line between mouse and 
receiver, and this claim 
appeared to be justified. You 
must not let anything get in 
between mouse eye and 
receiver, though - this device 


- works at a frequency close to 


the visual range and pointer 
movement ceases once there is 
no line-of-sight connection. You 
can tell if the connection is good 
by watching the flicker of what 
looks like an LED in the window 
of the receiver; no flicker when 
the mouse is moved means the 
signal reaching the receiver is 
not large enough. 


Same habits 


Almost everything about using 
a standard mouse applies 
equally to the infra-red mouse. 
You would not notice the 
difference normally. From an 
operational point of view, the two 
mouse kits are essentially the 
same. The infra-red mouse will 
appeal to users who do not 
want a cable between. the 
mouse and the QL. Bear in 
mind, however, that the receiver 
unit required by the infra-red 
mouse has a cable which is 
much the same length as that 
on a standard mouse, and the 
same type of adapter is required 
for the Serial port; that is, you 
have to find space for the same 
amount of connectors and 
cable, plus the receiver unit. 

If you are in the habit of taking 
your tea on a tray, a few feet 
from your QL, you could still play 
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your favourite game, without 
simultaneously pouring coffee 
into the QL’s delicate keyboard 
membrane. The maximum 
range would be about 8-9 feet 
(allowing for the length of cable 
attached to the infra-red 
receiver). Where space for the 
QL is limited, as it is on my 
workbench, the cable from a 
standard mouse can be a real 
nuisance. Two mice use the 
same mouse-pad on my bench, 
causing a considerable tangle 
of cable, and a certain amount 
of confusion for the other, 
occasional user! The infra-red 
mouse definitely has the edge 
over the standard one in such a 
situation. 

The mechanics of the 
standard and infra-red mice are 
similar and you would need to 
clean the ball and rollers on 
both periodically. Neither one 
really requires a mouse pad to 
work on, but each might operate 
more consistently with one. 


Conclusion 


For using with Pointer 
Environment programs, 
SERMouse looks to be well 
worth having. Maybe some of the 
existing, popular programs will be 
adapted for use with this driver 
one day (but don't bank on it). 
The all-in prices quoted for the 
mouse/cable/software package 
are reasonable, bearing in mind 
what it would cost to have a 
cable specially made up. The 
normal shop prices for PC mice 
start at about £20 plus VAT, but 
you can get mice at half this 
price (or less), Above all, the 
package makes addition of a 
mouse to the QL a relatively 
painless experience, which is 
something that could not be said 
about several of the previous 
offerings. As the writer of the 
software commented, his 
approach may not be the best 
solution to the problem, but it is 
possibly the only one which 
provides something which is 
both cheap and easy to install. 
Experienced, regular users of 
application programs can usually 
get along faster with the 
keyboard, but less-experienced, 
occasional users would welcome 
the facility to click on menus 
containing meaningful words, 
rather than trying to remember 
the keypresses for commands. 


Program: SERMouse 2.07 (kit of software, mouse and adapter cable) 
Price: £49 (standard mouse) £55 (infra-red mouse), £45 (standard 


mouse), plus £5 or £9 P&P. 


Suppliers: W N Richardson & Co, 18-21 Misbourne House, Chiltern 
Hill, Chalfont St. Peter, Bucks SL9 9UE. Software87, 33 Savernake 


Road, London NWS 2JU. 


Hermes .. 


relatively new product for the QL 
which aims to cure various 
problems with the QL’s 8049 
intelligent peripheral controller 
chip. The IPC chip is situated 
just to the left of the two 
microdrives and_ controls 
keyboard input, sound, and 
serial inout (although not serial 
output which is controlled 
separately). The 8049 contains 
some poorly-designed code, 
which causes problems in all 
these areas. The main problems 
are poor handshaking on serial 
input, leading to loss of some 
characters; keybounce; 
unreliable handling of serial 
input at baud rates greater than 


1200 baud; and ‘serial overrun’. 
Serial overrun occurs when 


data is being read from the 
serial port; the 8049 seems to 
hold onto some characters and 
then release them all at once 
when the next character is read. 
This leads to extremely 
unreliable serial input, and the 
only cure would seem to be to 
turn the computer off and on, 
and start all over again (resetting 
the QL does not always clear 
the problem). 


Predecessors 

There have been other 
versions of the 8049: a later 
version from Sinclair Research 
and another independent 
release. Both of these only 
addressed the keybounce 
problems, and the latter actually 
introduces additional problems. 
Hermes sets out to fix all the old 
problems, and at the same time 
provide additional flexibility to 
the QL 


Living with 
Mernies 


Another view of the Hermes ILP from Rich Mellor 


With the chip, you receive a 
seven-page manual and a disk 
containing some machine code 
extensions to access the 
additional utilities provided by 
Hermes. Oddly enough, the 
instructions for fitting the chip 
are at the back of the manual 
(although there is a contents 
page to direct you to the right 
place). If you follow the 
instructions, fitting the chip is 
relatively easy - you need to 
undo eight screws on the 
bottom of the QL and take it 
apart. Having located the 8049 
chip, you then lever it out of its 
socket using a small flat-bladed 
screwdriver. 

However, this is not easy 
because one end of the socket 
is very close to the edge of the 
QL case, so that the screwdriver 
can only be inserted at one end, 
making it all too easy to bend 
pins on the chip. Removal 
would be easier if a chip 
extraction tool was supplied, but 
with care and patience, the 8049 
can be removed without 
breaking any pins. Hermes is 
then slotted into the socket, 
given a firm push home, and the 
QL put back together. 

If you have anything else 
inserted into the 8049 socket, 
there is no need to worry as 
Hermes is exactly the same size 
as the original 8049 chip. 


Key click 

Once in place, the QL can 
then be switched on - if there 
are any problems, then you will 
not get the F1.F2 start-up 
screen. The QL should now 
operate as before, however, the 
first thing which you will notice is 


the little click whenever a key is 
pressed. Reading through the 
manual, | see that this click can 
be tured off either by using the 
command IPCEXT 6 (after 
loading the supplied machine 
code extensions) or by pressing 
the keys  Ctrl-Alt-Esc-4. 
Unfortunately | cannot 
recommend this keystroke, as 
my full-sized keyboard makes it 
very difficult for the QL to 
recognise that another key is 
being pressed at the same time 
as the Esc key (or that two letter- 
keys are being depressed, for 
that matter). This is however a 
problem with the Jurgen 


‘Falkenberg keyboard interface 


(or possibly a PC keyboard) and 
therefore | cannot blame TF 
Services. 

The keyclick is automatically 
enabled when the QL is 
switched on, but Minerva users 
will be pleased to note that if 
they turn it off, when Minerva is 
reset with a soft reset, then the 
keyclick remains disabled. 
Unfortunately, Hermes cannot 
produce a keyclick when a key 
is being auto-repeated (ie when 
it is held down to produce the 
same keystroke several times) 
as this is handled internally by 
the QL. Keyboard input is 
inevitably slightly slower with the 
keyclick enabled, but 
interestingly it also seems 
slightly slower where the 
keyclick has been turned off. 
This may of course be due to 
the extra code which is needed 
to check whether or not to 
produce the keyclick. 


While on the subject of 


- keyboards, | was pleased to see 


that Hermes improves key 
rollover, because since | 
installed my _ replacement 
keyboard, | have found it difficult 
to play games on the QL This 
was because key rollover did 
not work very well at all (it was 
much better on the original QL 
keyboard), so that if | was 
pressing two keys at the same 
time (for instance, to move 
diagonally), if | released one key, 
the QL failed to recognise that 
the second key was still being 
depressed (forcing me to 
release both keys and then 
press the second key again). 
With Hermes, this problem is 
resolved, and | can happily play 
my favourite games once again 
(which by itself makes it worth 
buying Hermes)). 


Baud rates 


One of the most impressive 
enhancements is the ability to 
have different input baud rates 
on both serl and ser2. The 
baud rates can also both be 
different from the output baud 
rate. The new __ function 
RXBAUD% is used both to set 
the baud rate for either ser1 or 
ser2 and read the current baud 
rate. Unfortunately, there is no 
way of reading the baud rate on 
one serial port without actually 
setting it, so you would need to 
use the following small function 
to do so: 


100 DEFine FuNction 
TEST_BAUD(ser_no) 110 


su 
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port=128*(ser_no-1) 

120 x%=RXBAUD%(port) 
130 
reset_baud=RXBAUD%(x%& 
&127+port) 

140 RETurn ~% 

150 END DEFine 


This should then be called by 
x=TEST_BAUD(1) for ser1 or 
X=TEST_BAUD(2) for ser2. The 
parameter returned by this 
function will then contain a 
value, the bits of which can be 
examined in order to determine 
if the given port is open or 
closed, whether it is affected by 
the BAUD command, and the 
current input baud rate used on 
that port. The manual explains 
the significance of each of the 
bits. 

This extension to the serial 
driver allows you to read data 
from a modem attached to ser2 
at 300 Baud, while still being 
able to access a printer at 9600 
baud on seri, without needing 
to alter the baud rate each time 
you swap between the two. 


New Basic 


Other new Basic commands 
allow you to read and set extra 
input.and output lines which will 
enable you to connect various 
items to Hermes. At the moment, 
the only utility | am aware of 
which uses one of these output 
lines is the Qview CAPSLED kit, 
which has to be attached to one 
of the pins on either the 8049 or 
Hermes, and then lights up 
when Capslock is enabled (or 
Ctrl-F5 pressed), A small 
diagram showing the location of 
these pins on the chip might 
help, but this is really for 
hardware developers. There is 
also a function which can be 
used to test if Hermes is present 


(as well as returning the version 


number of Hermes) and one 
which allows you to read all 128 
bytes of memory contained in 
Hermes (only six addresses are 
currently of interest to anyone, 
and these can mosily be 
accessed by the other 
commands). 

Machine code programmers 
who wish to use Hermes 
facilities can do so through the 
MT.IPCOM trap, which allows 
you to access either the 8049 or 
Hermes. The MT.IPCOM 


uU 
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command only supports a 
maximum of fifteen commands, 
and on a standard QL, all of 
these commands are actually 
used by the 8049, although 
many books on the QL 
operating system do not list all 
of these. The manual explains 
that Hermes has to be accessed 
by first using the MT.IPCOM 
command $9 (Microdrive 
Reduced Sensitivity - a 
command which actually did 
not work on an 8049) with a 
parameter of $9 to switch on the 
Hermes extra command set. 

Having done this, you can 
then check if Hermes is present 
by using the MT.IPCOM 
command $F (Test), which 
returns the complement of the 
byte sent if Hermes is present 
(on a standard 8049, | believe it 
returns the same byte that was 
sent), Provided that Hermes is 
present, you can then access its 
utilties by using the Microdrive 
Reduced Sensitivity command 
with various parameters (all of 
the other commands remain 
active, with their original 
meaning) - the Hermes 
command set is only switched 
off once you have accessed one 
of its utilities using the 
Microdrive Reduced Sensitivity 
command. 


Programming 

All of this would make sense 
to a machine code programmer 
(honestly!) if only the QL books 
contained more information on 
how to use the MT.IPCOM 
command, as the actual syntax 
is extremely complex. The only 
books | have come across 
which contain enough 
information on the syntax are 
Andrew Pennell’s QDOS 
Companion and the QL 
Technical Manual, although 
even these do not explain how 
you are supposed to use the 
Microdrive Reduced Sensitivity 
command (presumably as it 
never worked!). Luckily, you can 
always disassemble the 
machine code extension file 
provided with Hermes in order to 
see how Tony Firschmann has 
used the MT.IPCOM command. 
Having done this, you can (after 
some work) find out how to 
access Hermes from machine 
code. (the machine code 
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extensions utilise all of the 
additional Hermes commands), 
although the way in which this 
switches on Hermes is a little 
obscure. 

The original Microdrive 
Reduced Sensitivity command 
only allows one parameter, 
however, the extension file 
seems to pass two parameters, 
the second of which would 
appear to be used to call the 
MT.IPCOM Test command at 
the same time. Still, machine 
code programmers need not 
worry why this is done in this 
way, as they need only copy the 
code into their own programs. 

This could have been made a 
lot easier by the incorporation of 
either a fully commented source 
code for the extension file, or 
even an example in the manual 
itself. | have forwarded to Tony a 
copy of the list of commands 
which | produced, and maybe 
this can be incorporated into a 
later version of the manual. 


Improvements 

The other improvements 
which are noticeable when 
Hermes is installed are 
improvements to the BEEP 
command - no longer does the 
pitch of the note dictate how 
long it will be sounded for, nor 
do the fuzzy and random 
parameters alter the actual pitch 
of the sound. Many people will 
have come across the key 
combination Ctrl-Alt-7, which 
was originally used to turn on 
some test equipment which only 
Sinclair owned (and to reset the 
8409), and crashes the 
computer without this 
equipment. This keystroke now 
produces CHR%&(255) plus 
CHR$(151), which as the QL 
Manual suggests. Instead, the 
keys Ctrl-Alt-Esc-7 can now be 
used to reset Hermes (which 
also crashes the computer), 
which is somewhat more difficult 
to press by accident. 

There are one or two 
problems which could have 
been addressed by Hermes but 
have not been yet. No extra 
baud rates have been added to 
the QL's repertoire (the current 
eight are still supported), 
although the manual suggests 


INFORMATION 


that these may be added in the 
future. KEYROW still suffers from 
the same problem that when 
three keys are pressed to form 
three corners of a rectangle in 
the keyboard matrix shown in 
the QL Manual, the key which 
appears at the fourth corner in 
the grid also seems to have 
been pressed. Also, according to 
the QL Manual, the Shift, Alt and 
Ctrl keys should be an 
exception to this rule however, 
on my old version of the 8049 
they aren't, nor are they on 
Hermes. Maybe this is just 
another example of an 
inaccuracy in the QL Manual 
rather than a design flaw. 
Despite the Hermes manual 
being a little too technical for 
some users (hopefully this will 
be improved as time goes by), 
Hermes manages to achieve all 
that it sets out to do, and | 
recommend it to anyone who 
has had problems with the 8049 
in the past, as well as those who 
want the extra facilities afforded 
it. 


= 


Product: Hermes replacement co-processor (V2.18) 
Supplier: TF Services, 12 Bouverie Place, London W2 1RB 
Price: £25 (£24 to Europe, £27 outside Europe) (state whether 


software on mdv or disk) 


e 
This article explains 


how HPDUMP converts a QL 
screen into a grey scale image 
suitable for any printer that 
supports Hewlett Packard Printer 
Control Language. It also 
presents a multi-tasking version, 
HPDUMP_TASK, which can 
replace Psion'’s GPRINT_PRT in 
some applications. 


Example screen 


The example screen comes 
from QL Xchange, via Dr. Bill 
Fuggle's LaserJet II printer, and 
shows that the dump routine 
does not distort the shape of 
circles, even though there is no 
simple correspondence 
between QL pixels and dots on 
the page printer. 

Listing One is the second half 
of last month's assembly code, 
and contains the routines that 
read the QL screen and send 
data to the printer. Before the 
screen can be printed, HRDUMP 
must tell the printer the graphics 
resolution and line width. The 
Mode4 screen uses 512 pixels 
per row. 

The string labelled SETUP150, 
near the end of Listing One, 
selects lines of 1024 dots at 150 
dots per inch, giving an image a 
little under seven inches wide if 
we allocate two dots per pixel. If 
the value t150R is replaced with 
t300R, you get the maximum 
Deskjet resolution of 300 dots 
per inch, and the image is 
halved in width and height, a 
little over two inches tall. 


Mode4 screens 


The Mode4 screen memory 
uses alternate bytes to store red 
and green components of the 
picture. Each pair of eight bits in 
adjacent bytes controls the 
colour of a single pixel. You get 
eight bits of green data, then 
eight red bits, and so on. 

lf HPDUMP sent these bits to 


the printer in the same order, red 
and green areas would appear 
as offset stripes, and the screen 
image would consist of 128 
stripes with black and white 
repeated. 

The screen needs to be 
unscrambled to suit the printer, 
with grey shades for red and 
green pixels and solid areas for 
black and white. The grey 
shades use patterns of dots, like 
QL stipples - try typing some 
SuperBasic commands after 
PAPER #0,4,0 or PAPER #0,0,2,0 
to see the effect | mean. 

As the significance of each 
screen bit repeats for every 
word, we could translate a group 
of eight pixels by looking it up in 
a table of 65536 entries, one for 
each possible word value. 

Each screen word might be 
represented as a row of 16 or 
more bits representing printer 
dots, in the right order. This 
would be very fast compared 
with routines that work a pixel at 
a time, like RECOL, but it needs 
lots of memory: 128K if we use 
two printer dots per pixel for grey 
shades, or even more with wider 
patterns for each pixel. 

HPDUMP uses a table of just 
512 bytes. It converts each 
green and red byte in tum then 
merges them together with OR 
instructions. This compromise is 
still quite fast, but less greedy for 
memory than the 128K table. 
The HPDUMP table holds 256 
words, with a value 0 to 255 
encoded in the even bits, and 
zero in the others. 

Each screen pixel 
corresponds to a printed pattern 
two dots wide and two or three 
dots high. This ratio makes the 
printout the same shape as the 
display. The code from DO_LINE 
to SKIP_LINE in Listing one sets 
all six dots for a white pixel, 
three for green or two for red. 

The BTST #0,D6 instruction 
before the third line of the 
pattern is generated means that 
the third line is skipped for every 
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Simon Goodwin explains screen-scanning and task generation in the second 


alternate pixel row. D6 counts 
the lines, so bit zero changes for 
each row of pixels. If you remove 


‘that line, and the following 


BNE.S SKIP_LINE, the printout 
will be taller than the display but 
grey tones will be more 
consistent, as every row of pixels 
gets treated the same way. 


Expansion table 


The expansion table values 
could be preset and stored in 
the file, but this would mean lots 
of tedious typing for readers, so | 
decided to generate it 
algorithmically. The code was 
sure to be much more quickly 
entered than the 512 bytes of 
data, and would occupy less file 
space. : 

The disadvantage is that both 
code and data occupy memory 
while HPDUMP is running, but 
this is not much trouble as the 
routine already needs a buffer to 
store data en route to the printer, 
and the table can fit alongside 
that allocation. The code uses 
512 bytes for the table, and 128 
bytes to buffer a single print line. 

If you invoke HPDUMP_TASK 
with CALL, or use 
HPDUMP_CODE, 640 bytes of 
temporary space are allocated 
on the common heap while it 
runs, and released afterwards. 
The task version has no need to 
allocate heap space, as it has 
660 bytes of private data-space 
when loaded. 

The extra 20 bytes allow some 
breathing space for the task 
parameters, if any. If the 
parameter string is long it will be 
overwritten by the table, but that 
does not matter as HPDUMP 
will have read it and opened the 
corresponding file by that time. 

The first version of the table- 
generating code was very 
simple - it just counted from 0 to 


part of HPDUMP. 


255, and tested each bit in the 


count byte to determine whether 


or not an even bit should be set 
in the corresponding word. BTST 
and BSET instructions use four 
bytes each, so the resultant 
code seemed rather long and 
slow. 

Discussions with Phil Spink 
led to the current version, which 


_ is less than half the size and 


three times as fast. It uses 
sixteen data bytes and 38 bytes 
of code to expand that into the 
full 256 words. The code may 
appear complicated, with its 
double indices and nested 
loops, but in fact each step is 
quite straight-forward, combining 
two bytes from the table into 
one data word. 

Register A3 points at the 
expanded table, while A1 points 
at the first of sixteen bytes of 
‘nibble’ data. A nibble, or nybble, 
is a fraction of a byte. In this 
case the nibbles count from 0 to 
15, using only the even bits of a 
byte, leaving the odd bits unset 
By convention bits are 
numbered from zero, the least 
significant, upwards, so bit 7 is 
the most significant bit of a byte. 

DO selects the most 
significant byte value from the 
table, while D1 selects the least 
significant, and D2 points at 
locations for the resultant word. 
DBRA loops count downwards, 
so the table is filled from the end 
backwards, but the order of 
calculation makes no difference 
to the result. 


Code vs data 


I's possible to imagine ways 
to build the table faster or from 
less data. For instance you 
could build the sixteen byte 
table from four nibbles, and then 
use much the same code to 
expand the bytes to 256 words, 


sun 
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but in practice the extra code 
outweighs the saving in data. 
For top speed, at the expense of 
space, there’s no substitute for 
pre-computed data, and the 
more the better. 

The routines DO_LINE, 
DO_LINE2 and DO_LINES vary 
to give patterns for grey rather 


oe l 


Jan Feb Mar Apr 


Jan Feb Nar Apr 
Axis 1 


CHOOSE FORMAT 


line at a time than to write the 
bytes two by two as they are 
generated by scanning the 
screen. 

Each line of dots is prefixed 
by the text labelled NEWLINE, 
which tells the printer to expect 
128 bytes. Notice that the 
number is written in decimal, 


Type Format number 
ynd_ press ENTER 


sbyteg flp3_sasel_scn, 131872 32768 


than simple stripes. DO_LINE2 
only sets the odd bits if both 
green and red bits are set on 
the screen. 

Each resultant word is 
exclusive ORed with the value in 
D5 to exchange black and white 
dots unless the ! parameter was 
used. If all bits of D5 are set, this 
reverses the brightness just 
before the data is stored in the 
buffer. 

SEND_LINE sends 128 data 
bytes at a time to the printer 
using SEND_STRING twice. First 
it sends the control sequence, 
then the data bytes from the 
buffer addressed by AS, It is 
much more efficient to send a 
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HPDUMP_TASK, a multi-tasking 
version of the HPDUMP 
command. Type this in and 
RUN it to generate the 
HPDUMP_TASK file on your 
chosen device. 

Notice that line 160 has been 
changed from the usual SBYTES 
to SEXEC, and an extra 
parameter ,660 
appears at the 
end of that 
command. These 
changes reserve 
the data-space 
needed by the 
task. EXEC reports 
‘bad parameter’ if 
you try to load a 
file without such 
data-space. The 
rest of the first part 
of listing Two is 
the same as 
usual, SO you 
need not re-type it 
if you have an 
earlier Toolkit 
loader on file. 

The hex data 
for the task 
follows, from line 
580 to 920. The 
length is the 
same as for last 
ino.n, Lah.. S 
HPDUMP_CODE, 
but this..IS. 2 
coincidence - the 
data bytes are 
different. 

HPDUMP stars 
in the latest DIY 
Toolkit volume, 
which explores 
the details of HP 


rather than encoded into a byte 
or word as it would be for an 
Epson printer. This makes PCL 
escape sequences relatively 
long but easy to read as all the 
characters are Ascii codes, The 
last letter of an escape 
sequence is capitalised, to mark 
the end. 

Once the DO_SCREEN loop 
has finished, HPDUMP checks 
the value of D7 to determine 
whether it should close the 
channel or release the memory 
buffer. 


Listing two 


Listing Two is a hex loader for 
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97K Nemary 


Print Control 
Language. 
Volume K 


includes the task, 
CALL and 
command 
versions of 
HPDUMP, full source code, 
configuration data for Quill and 
Xchange, dozens of SuperBasic 
extensions to select printer 
founts and styles and a TRA 
code translator for special 
characters, which suits all Qdos 
variants except AH and JM. 

There are now 24 volumes of 
DIY Toolkits available on disks 
and microdrives. Prices have 
been cut to a flat rate of £3 each 
on 3.6 or 5.25 inch Qdos disks, 
or £4 volume on cartridge. 
Orders are despatched by first 
class or airmail post, included in 
the price. 

Please send sterling cheques, 
postal or money orders - not 


Task po 


credit cards. If you order two or 
more volumes you will receive a 
laser-printed leaflet of 
documentation for each, at no 
extra charge. To obtain volumes, 
or further information, write to Dr. 
Bill Fuggle at DIY Toolkit, 86 
Lordswood Road, Harborne, 
Birmingham B17 9BY, UK 


HPDUMP_TASK can run like 
any other task, from the standard 
EXEC or EXEC_W commands. If 
you. use EXEC_W _ the 
SuperBasic interpreter waits until 
the printout is complete before 
re-starting. EXEC 
FLP1_HPDUMP_TASK lets you 
Carry on using the machine, but 
if you change the screen while 
the task runs the printer will 
show a mixture of the old and 
new screens, and even if you 
type nothing the waiting cursor 
may end up on the printout. 

Minerva users have no such 
problem as they can swap to 
the other screen once printing 
has started, and carry on using 
that display while HPDUMP 
prints the other one. The task 
automatically detects which 
screen is in use when it is 
invoked, and continues to print 
from that one even if the user 
selects the other. 

If you use a Sinclair rom, Thor 
or other emulator, and don't 
want to wait for the printer, you 
need to re-direct the output of 
the task to a buffer which can 
be printed later. There are lots of 
ways to do this, often relying on 
extended versions of the EXEC 
command which let you pass 
parameters to the task. 

Some systems, like the Thor 
and SuperQboard, can insert a 
buffer on the way to the printer, 
where data is stored temporarily 
until the printer is ready for it. 
These work well with HPDUMP, 
but you need to reserve about 
100K for the information used by 
a single dump. In this case 
EXEC_W HPDUMP_TASK will 
complete in about a second, 
leaving the screen ready for 
other uses, but the printer will 
carry on for a minute or more, 
using data from the buffer. 

If you have QJump's RAMPRT 
driver installed, and a Toolkit that 
allows EXEC parameters, you 
can direct the dump to the 
buffered print device PRT. This 
works much.like the buffered 
SER or PAR device, except that 
you need to pass the name PRT 
to over-ride the default of SER. 


This is the SuperToolkit 2 
command: 
QL World DIY Toolkit, HPDUMP for Qdos screens, Part II 


EW HPDUMP_TASK;"PRT" Version 2.18, Copyright Simon N Goodwin March/April 1993 
Continued from Listing 1, QL World 1993 issue 5, page 28 
Use QW instead of EW if Send initialisation sequence 
using the Qliberator toolkit. The moved 4210 ds et Serer 
Turbo Toolkit equivalent is: _— ota iad acer string 


bsr send_check 


EXECUTE_A Fast table maker v2.1 by Simon N Goodwin & Philip R Spink 


HPDUMP_TASK;’PRT” 38 bytes of code +16 data bytes; 60 per cent shorter and 
three times faster than vl. 


Add an exclamation mark at pote ier ey eecintaatenibbie data 
the end of the name if you want AS -> line buffer, A3 -> pixel table, Al -> Nibble table 
a true grey scale, rather than the * 2%, cod Bee . 

’ ' move: , uter oop counter 
default which Saves ink by high_loop mded #15,da1 Inner loop counter 
swapping black and white in the low_loop eves EH Form target index in D2 

i dd. a1,a2 D2 := DO * 16 + D2 
printout, 1 naalG a2 ,a2 D2 is a word index 

If you always have QJump's move.b 0(a1,d0.w) ,a4 
RAMPRT, or its equivalent, ada 9s/0(o5,Qiswpiten*, <1 poiestat los byte. 
loaded you can patch the task move.w 44,0(a3,d2.w) Store combined word 

. dbra di,low_loop 
to replace the device name SER dbra a0 ,high_loop 

. . ‘ * 
with rian call meee a * Print out the screen addressed by A4 
norma commana. If you * 2 4 
don't want to re-assemble the és. eee ae Rane ears 
source, the easiest way to patch wee Laos Build line at A3 
the task is with The Editor or - move.b Green byte 
Spy. Adam Denning’s FEDIT will es Make SaEeninseN 
do the job, but scrambles the sae ate Move odd to even bits 

4, m , 

task’'s data-space so you must Sek tariedl Red, byte 

' ie dd. a1,di Mak ad ind 
reset it to 660 bytes after editing ei 0(a2,d1.w) ,d2 Mix rea £ green data 
We ESCUsS enfin (gah: 
DATASPACE_TASK from abra_ d0 ,do_line 
Supercharge or Turbo, or pees igengtine 
SetHEAD, from DIY Toolkit : lea.l -128(a4),a4 Go back again 

moveq #63,da0 Do 64 words 

Volume F. movea.l a5,a3 Build line at A3 


If you intend to print the same 
image repeatedly it is worth re- 


do_line2 moveqg #0,a1 


directing the output of move.b (a4) ,dl Green byte 
HPDUME Tih 3 a file, and mbes Ofgem re oat aire 
copying that to the printer as es Se oe ed : 
F r . (a4)+,d1 G 
required. The Toolkit 2 SPL and. (a4) ra Green AND rea? 
command is useful here, as it aope.w o(e2,citjedy CAget tie other Bitd 
. A dd. dil,di Make th 
can be directed to any device oa ay d1,d2 Canter oinane even 
and uses a background task to eor.w 45,2 
copy the information while you are | ablda Lines 
get on with something else. oe ae Skip one line in six 
Alternatively, use a compiled > bne.s — skip_line 
COPY command. * Send the final line of dots for this QL pixel line 
* 
lea.l -128(a4),a4 Go back again 
ll Do 64 ‘as 
_ On call oe ee ee 
Although the file is named do_line3 —_ moveq 
. -b G b 
HPDUMP_TASK, you can also move. < ee ee ints 
invoke it with a CALL command, move.w .0(a2,d2.m) ,42 Get the odd bits 
rather like Psion’s GPRINT_PRT. cae tacaiak yee 
j dd. di,di Mak d ind 
Some commercial programs move.w 0(82,di.w),d1 Get the other bits 
generate an Epson printer dump add.w dl, Make them even 
by loading GPRINT_PRT and corey a5,d2 “aaa > idea 
’ ‘ . a2,(a3)+ 
calling the start of its code, as Seer ean saa 
explained in this month’s n bsr.s  send_line 
SuperBasic in Action column. ~ eeipaine faba G6 ,do-eeredn 
Programs that do this, such as ns move RSE Cm, MURSCEeCe 
3D Terrain, work just as well with close_out tst.1 Check EXEC/CALL flag’. 
an HP PCL printer if you replace mee Ge No RECHP for tasks 
the supplied GPRINT file with a i meee 
renamed copy of trap 
ex 
HPDUMP_TASK. The code can tiagup  Tnowe of 28 
tell whether it was invoked by Srep 
a ok Ret [et 
EXEC or CALL, and checks its ie Soe oe ae 


parameters appropriately. 
Unfortunately HRPDUMP_TASK 
cannot be used directly as a 


u 
San 
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replacement for GPRINT_PRT, 
as Psion include a collection of 
undocumented data values at 


: Write the line of pixels at A5 to channel AO the start of their routines and 
gana tine . newline al these are absent from 
“w= (al)+,d2 Fetch length HPDUMP, so Easel rejects the 
send_string Initialise line . ‘ 
fall_out file and Xchange refuses to 
file ,a2 aoe install it | hope to work out the 
send_check a send_string format in due course, and 
fall_out 1. #4,a7 Discard return address update volume K appropriately, 
iy a close_out but in the meantime you can 
send_string mare 7/40 IO.SSTRG print Easel screens by saving 
; move.l  40,d4 Set 2 flag if it worked them to disk or microdrive, 
geitoke rts reloading them with LBYTES, 
: Table of values 0 to 15 in even bits, with odd bits zero and printing them from 
nibbles de.b 0,1,4,5,16,17,20,21,64,65,68,69,80,81,84,85 SuperBasic, like this: 
* 
* HP PCL escape sequences, at the end for easy patching 
ee am 4 LBYTES 
io : ‘SERI! FLP1_PSION_SCREEN,131072 
newline 7 
ae He : = a 128 bytes per line EXEC_W 7 
setup: 5 
3 27,/*t150R/ 150/300 DPI density FLP1_HPDUMP_TASK 
x 27,'*r1024S’ 1024 pixels per line 
extension 'd be most interested to hear 


* 


define One procedure 


5, from anyone who has details of 
hpdump-* the Psion _PRT header format, 
areal i and as always | welcome 
comments and suggestions 
from DIY Toolkit readers. 

Next month I'll be back with 
an in-depth report on a new 
version of Psion’s Xchange suite 


extension 


REMark Space requirements for the machine code 
DATA 484 


DIY TOOLKIT HPDUMP_TASK loader - LISTING 2 


REMark Machine code data 
DATA "600E322E31384AFB" ,"0006485044554D50" 
REMark Sinclair QL World HEX LOADER v 3b DATA "41 FAFFEEBDC8665A" , "7E01301F670A76F1" 
REMark by Marcus Jeffery & Simon N Goodwin DATA "534066487EFF205F" ,"7A0030176F160C37 
: DATA "0021000166067AFF" ,"535767084A876B4E" 
CLS: RESTORE : READ space: start-RESPR(space) DATA "204F60084A876B1A" ,"41FA017872FF7602" 
PRINT "Loading Hex..." : HEX LOAD start DATA "70014E4226006614" ,"7001D05F08800000 
INPUT “Save to file...";£$ DATA "DFCO4BF6C0002C08" ,"613A260072FF7005" 
SEXEC f$,start,byte,660 : STOP DATA "4E417AFF4A816602" ,"7A0041FA01467E00" 
: DATA "72FF760070014E42" ,"4A80660001042C08" 
DEFine FuNction DECIMAL(x) DATA "223C0000028074FF","70184E4128006600" 
RETurn CODE(h$(x))-48-7%(h$(x)>"9") DATA "OOEA2A4845ED0080" ,"287C000280007000" 
Ze ae DATA "43FA011034196100", "OODA264A43FAOOEA™ 
$ ’ 
"700F720F3400E94A" , "D441D44218310000" 
DEFine PROCedure HEX_LOAD(start) — ' 
ivte «6 ( cluskauk 24 BATA SHEA teas 24" , “200081 COSPESS ICS" 
ee a ee DATA "34321000D4427200","121¢D24166721000" 
READ h$ : . vie . 
IF h$="*" ; EXIT load_hex_digits DATA "BB4236C251C8FFE4" , "617849ECFF80703F 


IF LEN(h$) MOD 2 


DATA "264D72001214D241", "343210007200121C" 
: unbél ‘vg ity: Gea ttcan DATA "C21CD24132321000","D2418441BB4236C2" 
ERIRDNOGE: noses Os Sx Gigite In: nay DATA "51C8FFE0614C0806" , "0000662A49ECFF80" 
DATA "703F264D7200121C" , "D241343210007200" 
a "1210D24132321000" ,"D2418441BB4236C2" 

= 1 TO LEN(h$) STEP 2 oa ' 
hb = DECIMAL(b) : 1b = DECIMAL(bt1) DATA "51C8FFE2611C51CE" , "FF7E78004A876B0E" 


IF hb<0 OR hb>15 OR 1b<0 OR 1b>15 DATA "6608C14D70194E41" , "C14D70024E422004" 
PRINT"Illegal hex digit in: ";h$ : STOP DATA "4E7543FA00343419","6110660A224D343C" 
END IF A DATA "008061066 70A588F" , "60D270074E432800" 
POKE start+byte,16*hbt1b~’ DATA "4E75000104051011","1415404144455051" 
Checkstm = ei = ae + ib DATA "5455000453455231" ,"00071B2A62313238" 
byte = byte +1 DATA "5700000F1B2A7431" ,"3530521B2A723130" 
END FOR b DATA "32345300","*" 39775 
END REPeat load_hex_digits 
READ check 
IF check <> checksum 
PRINT "Checksum incorrect. Recheck data.":STOP 
END IF 
PRINT "Checksum correct, data entered at: ";start 
END DEFine HEX_LOAD 
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MicroEmacs 
A | 


Hilary Snaden 

Following the review of version 
3.9p of the public domain text 
editor MicroEmacs in QL World, 
August 1992, version 3.11 has 
been released. The new version 
is based on an updated source 
code together with a rewrite of 
QL-specific code by Richard 
Kettlewell. 

Included on the disks are a 
number of utilities written in the 
MicroEmacs command lang- 
uage, together with a number of 
machine code programs for file 
manipulation which may be 
invoked from Basic or from 
MicroEmacs itself since the 
commands which invoke outside 
programs now work. Environment 
variables are also supported, if 
the necessary extensions to 
superbasic have been installed. 

The program now copies the 
DATA_USE and PROG_USE 
devices for its own use if Toolkit 2 
is present, and if started from a 
command line wildcard 
filenames are accepted so that, 
for example, it can be set to read 
a series of files. MicroEmacs can 
also now complete filenames in 
the same way as buffer and 
procedure names. 

The way that function keys are 
interpreted is now more in line 
with established QL conventions, 
and the help facility has been 
substantially expanded. Paper 
and ink colour can be changed 
properly, and the QL's clock can 
be read as a MicroEmacs 
variable and added to 
documents: this is used by one 
of the new utilities, which 
produces a_ three-month 
calendar, centered on the current 
date, which can be incorporated 
into documents. 

Commands such as list-buffers 
and describe-bindings now use 
a_ volatile window’ which 
disappears, restoring the original 
screen, on the next keypress. 
Screen handling is noticeably 
faster thanks to a major rewrite of 
the display code. MicroEmacs is 
fully compatible with Minerva. 

One potential problem 
remains: memory grabbed by 
MicroEmacs for storing files 
being edited is not released until 
the program is exited. 

MicroEmacs 3.11 as source 
code and a ready-to-run program, 
together with documentation, is 
available from public domain 
libraries. 


QXL’S Brum Debut 


Simon Goodwin 

The new QXL from Miracle Systems was 
unveiled at a packed meeting of QL enthusiasts 
at Birmingham's. Holloway pub, home of the 
West Midlands Quanta sub-group. The QXL is a 
fast QL emulator board for PC compatibles, 
based around Motorola's 32 bit EC 68040 
processor. 

The QXL was shown alongside the Gold Card, 
and succeeded in making even that look slow 
by comparison, Stuart Honeyball started by 
running QL Quill on the PC-based QXL, copying 
lines repeatedly to create a file of several 
thousand words in a few seconds. 

Even programs that write directly to QL 
memory work on the QXL, as the 68040 copies 
the 82K QL screen to the PC display adapter. 
Normal QL displays appear in the middle of a 
larger VGA screen, and programs that do not 
write directly to the QL display memory can use 
the extra space for text or graphics. The current 
version is limited to Mode4, but Miracle plan to 
add support for Mode8 in due course. 

The QXL has its own memory and only needs 
the PC as a peripheral controller. It starts up from 
two disks, one in PC and one in Qdos format. 
Once the system is loaded users can return to 
the MS-DOS prompt, issue DOS commands, 
and re-start the QXL at the point they left off 


New Discoveries 


Simon Goodwin 


Prolific C programmer Dave Walker has extended his DiscOver 
and Multi-DiscOver utilities to read and write HD and ED disks in PC 
format, on any QL with a Gold Card and a suitable drive. The new 
version will also format 1.44 megabyte HD disks in PC or QL format. 

The PC's little-used 288 megabyte format is not available, as the 
Gold Card uses larger sectors to put 3.2 megabytes on each ED disk, 
but the upgraded DiscOver can read, write and erase files on ED 


disks formatted by a PC. 


Multi-DiscOver version 3.01 can also access files in the MGT disk 
formats used on many Spectrum and SAM computers. Again it is 
possible to read, write and erase files with any double-density drive, 
but the: program cannot actually format disks in MGT’s 800K ten- 


sector format. 


A new format specification file allows easy access to 706K 
Amstrad disks. These come from later Amstrad PCW machines and 
the Spectrum Plus Three with external drive B: fitted. The same format 
is also used by ProDOS, the SAM CP/M system, so it is now possible 
toconvert files from those sources to suit Qdos CP/M emulators. 

Freely-distriputable demonstration versions of DiscOver, Multi- 


The SMS4 operating software was still in prototype 
form at the sub-group meeting, limiting testing. There 
was no SuperBasic interpreter, so Toolkits could not 
be loaded and it was only possible to run stand- 
alone QL tasks, 

The only PC device supported was the floppy 
drive, at a leisurely speed compared with a QL drive, 
but programmer Tony Tebby plans to fine-tune the 
speed and add support for SER, PAR, NET and WIN 
devices over the summer. Miracle promise free 
updates when the software changes. 

The QXL was happy to run the PD version of QL 
Xchange from the sub-group's library, as well as 
Quick Mandelbrot Iii supplied by Rich, Mellor. This 
revealed one apparent glitch, showing a co-ordinate 
ten times the correct value, and Miracle and Mellor 
are collaborating to trace the source. The display was 
correct, and generated two to three times faster than 
by the same code. on a Gold Card. 

The QXL costs between £295 and £495 
depending on memory configuration (one to eight 
megabytes) and requires a PC XT or compatible with 
at least 512K ram, EGA or better display, and one 
free slot. It will work on a basic 8-bit PC but benefits 
from the extra signals of a 16-bit ISA slot. The 
development version expects the PC to have AMI 
BIOS chips, but should be largely compatible with 
the Phoenix alternative. 


DiscOver and TexTidy are now available from QL Bulletin boards and 
PD suppliers. The demo versions come with complete 
documentation in Quill files on the disk, and are fully functional 
except that it is not possible to write files of more than 512 bytes. You 
can read, erase and format disks, and check that the programs do 
what you want. 

The demonstration tasks and full programs are available from 
Dilwyn Jones Computing, tel. 248 354023. Discover, for QL, PC and 
ST formats, costs £20, while Multi-DiscOver adds Spectrum, CP/M, 
Unix and BBC file support, for an extra £10. The file conversion utility 
Textidy is priced at £15. These programs require a QL with at least 
256K of memory and suitable drives. 
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Solutions 


Howard Clase with two more routines for Quill users. 


Continuing 


the theme of SuperBa 
programs to ease the lives of 
Quill users here are two more 
ideas, one inspired by a 
correspondant in a North 
American QL newsletter, and the 
other in response to no less 
person than QL World’s own 
editor. 


Make Your Own 
Printer Driver. 


One of the most frequent 
requests from Quill users is for a 
way to increase the ten 
“translates” in the Psion printer 
driver which enable you to send 
special instructions to the printer, 
such as to turn on italics, or to 
get the printer to print characters 
from the second character set 
correctly. One way around this is 
to use the QL's second 
character set as control codes 
with your printer set to receive 7- 
bit Ascii (for many printers this is 
the default - see Psion Solutions, 
April 1991). But what if you want 
to print a large number of 
foreign characters from the 
second set, text containing both 
French and German for 
example, which would require at 
least 12 additional characters? 
The answer is, of course, to do it 
in SuperBasic, using a 
supplementary printer driver. 

A printer driver has to check 
each character before it is 
printed to see whether it should 
be sent to the printer as it is, or 
translated into something else, 
like the codes for switching on 
superscript, or to substitute the ~ 


SUN 


character for the #. It isn't difficult 
to write a program to do this, but 
since we cannot run a 
SuperBasic program from within 
Quill it has to be a two step 
process. For once the slow 
speed of interpreted Basic isn't a 
problem - it has no difficulty 
keeping up with most printers! 

A skeletal program of this kind 
is given in Listing one, It is 
designed to work on a “_lis” file - 
the kind that is generated from 
Quill when you type in a file 
name instead of pressing Enter 
when the words “to printer” 
appear at the bottom of the 
screen during the printing 
sequence, (As you start to type, 
the word “printer’ will vanish so 
that you can enter a file name of 
up to eight characters and, 
unless you add a different 
device and/or three letter 
extension of your own, the file 
will appear on your default 
device with the “_lis’ extension) 
This file is exactly the set of 
bytes that would have been sent 
to the printer via your current 
printer_dat driver, and. will 
already contain all its printer 
control codes and translates. For 
the Psion suite, listing five is a 
supplementary printer driver; it 
adds to Quill’s internal printer 
driver. You need to bear this in 
mind when writing your 
program. But, although | started 
out with the idea of 
supplementing the Psion printer 
driver the program is quite 
general and will work on any 
listing that is basically text, in 
particular, SuperBasic listings 
that include foreign characters. 
Listing five was used to print 
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itself on my old Epson FX85; | 
couldn't just LIST it to my printer 
since it contains second set 
characters in the REM 
statements. 


The Program 


Because there are almost as 
many models of printer as there 
are QL users there is no point in 
my providing a complete 
program that would be useless 
to many readers, so listing five is 
just a skeleton containing 
examples of the kind of thing 
you can do. I'm afraid it's up you 
to struggle with your printer 
manual and flesh out. the 
assignments exemplified in lines 
160 to 200 to meet your 
requirements. You can extend 
this collection of definitions by 
using the RENUMBER 
command to make more lines. 
All the codes in the listing are 
Epson ones, and the examples 
do work on a genuine Epson. 
You may have to change some 
or all of them for other brands; a 
claim of “Epson compatibility’ is 
no guarantee of an 100% match 
in my experience. One thing you 
will need to pay attention to is 
the printer channel definition in 
line 145; most people use ser1 
here. 

The second character set 
occupies the 64 Ascii values 
from 128 to 191. A “look_up” 
array, new$, to hold 64 strings of 
up to 10 characters is set up in 
line 155 and initially filled with 
spaces; change the second 
parameter if you want to use 
longer strings. NB: the DIM 
statement only reserves even 
numbers; odd requests are 
increased by one. Add 127 to 
the array index to get the 
corresponding Ascii code such 


as new$(1) coresponds to 
CHRS$(128). The special 
characters can be called up 
from your printer in two ways: by 
sending the codes to select a 
foreign character set containing 
the desired character (lines 160, 
170, 195) if it is available, or by a 
bit of creative overprinting e.g. 
the division sign by a dash and 
a colon (lines 165, 185, 200 - 
bs$, CHR&(8), is backspace) If 
you want to leave a character in 
the 128 to 191. range 
unchanged you must put it back 
in again (175, 180). | chose the 
space as default since not all of 
the characters can be generated 
by these methods and it gives 
the opportunity of insertion by 
hand. Note that the assigments 
must be characters or strings: 
defined as CHR$0, one or more 
characters in quotes, or a string 
variable; and they must be 
combined with &s. These are 
assigned to the array as 
required to replace the spaces. 


| hate having to type the same 
thing repeatedly, so | have 
defined a set of string variables 
(105 - 130) to call up the various 
language codes in mnemonic 
form (Fr$ = French, etc). The 
default on my printers is US 
mode (there isn't a Canadian 
one!), and this has to be 
restored after each foray into 
foreign parts; to save typing 
again, this is automatically 
tacked on to every member of 
the array which is more than 
three characters long at line 210. 
(If it's: shorter than this it cannot 
contain a nationality change) If 
necessary, change this to match 
your required default character 
set; for instance, use Sw$ if you 


normally type in Swedish. 

As written, the program only 
checks the characters from the 
second character set with Ascii 
values from 128 to 191 and the 
“" sign (CHRS(Q6), but this can 
easily be altered (lines 325 to 
240). (The code at line 335 is a 
one off to deal with the “”) The 
normal characters and printer 
control codes all fall below 128, 
and are passed on unchanged 
(325). If your printer_dat 
processing sends out any 
characters in the 128 to 191 
range then you will have to 
watch out for conflicts, but this 
shouldn't be a serious problem. 

If you have Toolkit 2 you can 
save also quite a bit of typing if 
you set up ‘new$0)=$&CHR$0' 
and ‘newS()=""&bs$&"” on a 
couple of ALTKEYs, and insert 
the missing numbers and 
characters as required. | find that 
if | am generating a composite 
character using backspace, | 
have to use unidirectional 
printing to get a tidy looking 
result (line 150). Try it without this 
on your printer too, since it saves 
time if you can print bi- 
directionally. You'll have to 
experiment here, as what works 
in one print style may not look 
right in another. If you are not 
sure about the keyings of some 
of the characters refer to 
“character set and keys” pages 
of the “Concepts” section of the 
QL manual. 

Some printers which accept 8 
bit Ascii, particularly those with 
IBM character sets, do in fact 
have most of the required 
characters, but with different 
values from the QL ones. In this 
case, since all that is needed is 
to substitute a single code in 
each case, it is probably simpler 
to put the new values into DATA 
statements and READ them into 
the array from these. 


Exporting 
Paragraphs 

In Psion Solutions for 
November ‘92 your editor 
commented that it reatly 
simplifies the desktop 
publishing process if Quill 
documents are exported to Ascii 
without any control codes or 
other formatting except for 
paragraph separations and an 
EOL (end-ofline - | presume the 
MS-DOS form “CRLF” is 
required) at the end of each 
paragraph. Here are a couple of 
ways it can be done. 

My first thought was that it 
would have to be done in two 
steps, using a SuperBasic utility 
on an ascii _lis file, but when | 
had worked this out | realised 


that it is after all possible to do it 
directly from within Quill. Both 
methods require a bit of “de- 
formatting” of the Quill 
document and specially simple 
printer_dat files. | think the latter 
is the most convenient way, so 
I'll give it first and in more detail. 


Printer dest 


The special printer.dat driver 
has to be created using 
install_bas. Select the default 
driver, bcause it is already pretty 
simple, and copy it by pressing 
Fi. Change the name to 
something else, set the lines per 
page to 0, and, most important, 
alter the end of line code so that 
it just inserts a space. To do this 
press the Right arrow to remove 
the old entry and then type a 
single apostrophe, then a space, 
and then hit Enter. Since the 
entry is a space it won't appear 
to be there, but the word “NONE” 
won't appear either. No EOL 
codes will appear at the end of 
each Quill line, and the last word 
of a line will be properly 
separated by a space from the 
first word of the next line. Leave 
preamble and all the type style 
entries as “NONE”. It's a good 
idea to put in “CRLF” as 
postamble to make quite sure 
there's an EOL at the end of the 
file. 

So far so good, but there must 
be an EOL at the end of each 
paragraph; since the driver 
doesn't allow you to define an 
EOP (end-of-paragraph) this has 
to be done using a translate. | 
chose the greek mu character, 
since that's what you get when 
you press Ctrl-Shift-P, but you 
can use anything you like that 
you can easily remember the 
keying for and which isn't likely 
to appear in the text. Move to 
translate 1, press Right arrow 
and then type ‘“<greek 
mu>,CR,LF,CR,LF” (omit the 
double quotes, key in <greek 
mu> as above, and insert 
enough CR,LFs to give a two- 
line separation between 
paragraphs. This means that 
every time the driver meets a mu 
it inserts the MS-DOS EOL 
codes to close the previous 
paragraph, and leaves an extra 
line (with returns) before the next. 

Entries relating to the serial 
port and page length etc. are 
irrelevant since you aren't going 
to be using this driver with a 
printer - if you do you may get 
rather odd results! If you are 
producing hardcopy to go with a 
disk file (the editor tells me) then 
the format doesn't matter too 
much as long as the words are 
right. The disk file format is the 


important one. 

Press F6 to install the driver as 
printer_dat on your default 
device, and then copy it to a file 
with a meaningful name so that 
you don't have to go through 
this rigmarole every time you 
want to carry out the operation. 


De-formatting 

The printer driver creates the 
left margin by sending the 
appropriate number of spaces 
to the printer at the beginning of 
each line, and the last thing your 
editor wants is a set of ten 
spaces inserted at regular 
intervals throughout the text! Nor 
does she want it to be 
punctuated by footers or 
headers every so often, so the 
Quill document has to be “de- 
formatted” before it is exported. 
Save it before you do this to 


nm$= 


top of your document and set 
justification F8-J to “left” to 
remove surplus spaces, and 
finally move both left and indent 
margins to the left hand edge of 
the screen F3-M. If there are no 
changes to justification or 
margins elsewhere in the 
document these should run 
right to the bottom; it's just as 
well to pop down there to make 
sure. If not, you'll have to go 
down the document paragraph 
by paragraph using Shift-Down- 
arrow, and reset the justification 
and margins wherever 
necessary. 

Now for the most tedious bit: 
in this system, you have to put a 
mu. at the beginning of every 
paragraph. This isn’t too bad 
when you realise that pressing 
Shift-Down-arrow moves you 
straight to the right place each 
time. If you have TK2 you can 


“DIY_Printer_driver" 


REMark (pd) hje 1992.07.13 ver 1.0 


REMark 


Setup: FPrint: Finish: STOP 


REMark 
DEFine PROCedure 
Pr$=CHRS(27)&"R": 
US$=Pr$&CHRS (0) 
GeS=Pr$&CHRS (2) 

OQ Sw$=Pr$&CHRS(5) 
It$=Pr$&CHR8(6) : 
Ja$=Pr$&CHR$ (8) 
CLS: 
c%=3: OPEN_IN#c%,n$: 
OPEN#c%+1,ser2he: 


DIM new$(64,9): 
newS(2)="a"&bs$&"~" 


new$(3)=Sw$&"}" 
new$(11)=CHR$(138) 


newS(15)=CHR$(142) 
new$(16)="“e"&bs$&Sp$&CHR$ (123) 
new$(28)="u"&bs$&"*" 
new$(32)="£" 
new$(60)="-"&bs$&":" 
FOR i=1TO 64 

IF LEN(new$(i))>3:new$(i)=new$(i)&US$ 


END FOR i: 
DEFine PROCedure 


END DEFine : 


bs$=CHR$(8) 
: Fr$=Pr$&CHR$(1) 
: UK$=Pr$&CHRS(3) 


Sp$=Pr$&CHR$ (7 ) 
No$=Pr$&CHR$(9) 
INPUT" ‘Device and file name to print: "\,n$ . 


REMark Unused channel 


REMark Your printer channel 
PRINT#c%+1 , CHR$(27)&"U1"; 
FOR i=1TO 64: 
new$(1)=Ge$&CHR$(123) 


: REMark one way 
new$(i)=" “ 
:REMark 4 
:REMark 4 
:REMark 4 
:REMark unchanged 
:REMark unchanged 
:REMark 6 
:REMark G 
>REMark '‘ 
:REMark + 


REMark 


LOCal a,loop: REPeat loop 
IF EOF(#c%):EXIT loop 
a=CODE ( INKEY$(#c%,-1)) 


SELect ON a 
=f. T0-95,, 


97 .TO..127, 


192 TO, 255 


PRINT#c%+1, CHR$(a) ; 


96: PRINT#c%+1, UK$&" #"&USS; 


:REMark £ 


128 TO 191:PRINT#c%+1,new$(a-127); 


END SELect : 
END DEFine : REMark 
DEFine PROCedure 
CLOSE#c%: CLOSE#e%+1 


END DEFine : REMark 


avoid having to undo all that 
follows! 

Go into display F3-D, and set 
the upper margin, page length, 
and bottom margin to zero, then 
set the header F3-H and footer 
F3-F to “none”. Now go to the 


END REPeat loop 


reduce the tedium to a single 
altkeypress by inserting the 
following into your boot 
“ALTKEY'p’,CHRS(220)&'<greek 
mu>"”, and then all you have to 
do is to hold down the Aly key 
and keep pressing p until you 


sun 
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nm$= “Exp_Paras” 
REMark (pd) hjc 1993.01.01 
REMark 
Setup: Process: 
REMark 
DEFine PROCedure 
LOCal L,lp: c%=3 : 
REPeat 1p 
CLS: INPUT"Device and file name:" \,n$ 
L=LEN(n$) 
IF n$(L-3 TO L)=="_lis": 
IF LEN(n$)<13: EXIT lp 
BEEP 25,3000: END REPeat lp 
OPEN_IN#e%,n$&"_lis": OPEN_NEW#c%+1,n$&"_haf" 
e01$=CHR$(13)&CHR$(10): REMark MSDOS form 
END DEFine : REMark 
DEFine PROCedure 
LOCal a$,i,L,lp 
REPeat lp 
IF EOF(#c%): EXIT lp 
INPUT#c%,a$: IF ag="": ag=" " 
IF a$(1)=" if 
L=LEN(a$) 
FOR i=1 TO L: IF a$(i)<>" " 
IF i<L: PRINT#c%+1, eolg$&ag; 
ELSE PRINT#c%+1," “&a$; 
END IF : END REPeat lp: END DEFine :REMark ~*~ 
DEFine PROCedure Finish 
PRINT#c%+1,e01$; 
CLOSE#c% : CLOSE#c%+1 
BEEP 5000,50: PRINT “DONE” 
PRINT\"New file name is “;n$&"_haf" 
END DEFine : REMark 


ver 1.1 


REMark Two unused channels 


n$=n$( 1 TO L-4) 


Process 


:EXIT i 


get to the end. 

Now you are ready to export 
your document. With the special 
printer_dat file in the right place 
(remember, you can copy it from 
within Quill using the “backup” 
facility <F3, F3, F, B, etc.>) “print” 
your document to a file <F3-P- 
Enter-Enter-file name>. This will 
give you a file with the text in the 
required format with the _lis 
extension tacked onto your 
name. 

The method of using a 
SuperBasic utility requires the 
same “de-formatting” of the 
above, except that the program 
assumes that any line starting 
with a space is a new 
paragraph, and omits any blank 
lines. (This could cause 
problems, as paragraphs are 
best separated by a blank line. 
However, Howard's samples 
worked. Ed.) It also requires a 
special printer_dat file, similar to 
the above except that the end of 
line code and postamble should 
be the QL's standard, LF only, 
and the translate isn't necessary. 
You must first generate your _lis 
file using this printer_dat driver, 
and then leave Quill for 
SuperBasic and run the _lis file 
through listing six. Since it deals 
with the file a whole line at a 
time it is quite quick. The output 
will have the extension _HAF. 


The programs listed in these 
articles are public domain: they 
may be freely copied, and 
distributed as long as no charge 
is made beyond a small 
copying charge. Copies will be 
available from the QubbeSoft 
public domain library for anyone 
who considers their own typing 
skills inadequate. Some 
additional, related material may 
also be available as part of the 
package as well as a collection 
of my public domain programs, 
including Ftidy, which was 
formerly available from the 
Microdive Exchange. 
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Beginners’ 


Machine Code 


In part 3, Alan Bridewell starts moving memory about. 


In the first part of this 
series, we just about managed 
to get something on the 
screen. In part two, we 
improved slightly with a pretty 
pattern, but not something of 
any great use. In this part | 
hope you will see a QL (that is, 
a Quantum Leap) in what we 
actually achieve. 

First, we shall look closely at 
how the assembler uses labels, 
and show how this leads to the 
need for another type of 
instruction, the LEA instruction. 
You should recall that labels are 
what we put into the left hand 
column of an assembler listing. 
They represent the address of 
the code following the label in 
the program. An important (but 
not the only) reason for labels is 
that programs can be loaded 
anywhere in memory, so that at 
the time we write the program, 
we do not know what actual 
address the label refers to. The 
use of a label ensures that the 
assembler will generate 
machine code which will always 
refer to the correct address 
regardless of where the program 
is loaded. How it does this need 
not concern us. 


Label syntax 


In order to use labels correctly, 
we need to leam the syntax 
rules about the way we refer to 
labels in MOVE instructions in 
assembler code. Suppose we 
have a label called ‘CA_GTLIN’. 
These rules are: 


1. If we refer simply to the 
label, eg CA_GTLIN, then we use 
the contents of that address as 
a further address, and we deal 
with the contents of that new 
address. 

2. If we put a hash (#) sign in 
front of the label, eg #CA_GTLIN, 


HEE KKH EKER E HEEL HHH IEE EKER E EE EEE EEE ELE HEEL EEE EIEN EERE EERE EREE EE 
SAVE AND RESTORE THE SCREEN 
HHH KEMAH EEK KEKE HEE LILES EEN HEEL ERE EERE EEL EEL EE EERE HERE EEE EEE 


SAVE SCREEN TO BUFFER 


MOVE.W 
MOVEA.L 
LEA.L 


BRA 


RESTORE SCREEN 


MOVE.W 
MOVEA.L 
LEA.L 
MOVE.B 


DBRA 


5 
- BUFFER 


then we treat the 
contents of that address 
as a number. 


To make this clear, we 
shall look at the effect of 
each type of instruction. 
Suppose the label 
CA_GTLIN refers to an 
address which contains 
the number $118. (This, 
by the way, is not one | 
made up. It has a 
special significance to 
Qdos, and your 
assembler may 
automatically accept the 
label CA_GTLIN as 
meaning the number 
$118, even if you do not 
actually say so in your 
program. More about 
that later) 

The instruction: 


MOVEW #CA_GTLIN,D1 

means “make the contents of 
the data register D1 into $118 
and discard what was already 
there’. 

The instruction: 

MOVEW CA_GTLINA2 


LOOP COUNTER 
SCREEN ADDRESS IN AO 
BUFFER ADDRESS IN Ai 
SAVE SCREEN 


#$8000, D0 
#$20000 ,AO 
BUFFER,A1 
LOOP 


wt wn we ae 


LOOP COUNTER 
SCREEN ADDRESS IN Al 
BUFFER ADDRESS IN AO 
MOVE CONTENTS OF (AO) 
TO (Ai), THEN 

3 INCREMENT BOTH 
IF DO > 0, THEN DECREMENT DO AND 
BRANCH TO ‘LOOP’ 
IF DO = 0, THEN LEAVE THE LOOP 
AND CONTINUE THE PROGRAM 
NO ERROR RETURN 


#8000, DO 
#$20000,A1 
BUFFER, AO 
(AO) +, (AL) + 


po, LOOP 


z=RESPR (32810) 

LBYTES flpi_LISTING1_code,z 
OPEN#3,scr_512x256a0x0 

CLS#3 

FOR n = 16-2 TO 1 STEP 1E-2 
CIRCLE#3, 100*SIN(n) ,100*COS(n) ,100#n 
END FOR n 
sstore 
PRINT#S3, 
PRINT#3, 
PAUSE -i 
CLS#3 
PRINT#3, 
PAUSE -1 
srestore 
CLOSE#3 
PAUSE —-1 
DEFine PROCedure sstore 
CALL z 

END DEFine sstore 

DEFine PROCedure srestore 
CALL 2+18 

END DEFine srestore 


"This screen has been stored" 
"Now press a key to clear the screen" 


"Now press a key to restore screen" 


means “take the contents of 
the address $118, and copy it 
into the address register A2, 
discarding what was already 
there”. If | actually did this on my 
usual QL which is a JM, | would 


get the number $5C4C in the A2 
register. On other QLs, Thors, 
Minervas or emulators you may 
get some other number. (| 
haven't tested this, so | can’t be 
sure) The point is, this is the 


u 
aaa 
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address in rom for the sub- 
routine used to take long word 
parameters from SuperBasic 
procedures and functions, A 
different rom may have that 
routine at a different address, but 
that address can always be 
found at address $118 in all rom 
versions. It's the use of numbers 
like this (called vectors) which 
make programs that use sub- 
routines in the rom compatible 
with different versions of the QL, 
but that is another story. 


Load address 


An important problem is that 
neither of these MOVE 
instructions will enable us to 
move the actual address of the 
label CA_GTLIN into a register 
for us to. use. To do this, we 
need another type of instruction, 
LEA, which stands for ‘Load 
Effective Address’, 

The instruction: 

LEAL CA_GTLINA2 


means “make the contents of 
the A2 register into the address 
of the label CA_GTLIN”. Note, 
this is NOT $118, which is the 
actual contents of the address 
CA_CTLIN, and it is NOT $5C4C, 
which is the contents of the 
address $118 (on the JM QL, 
anyway). 

An important use of a label is 
to refer to the address of the 
start of a block of memory which 
can be used temporarily to store 
data generated while the 
program is running. Such a 
block is usually referred to as a 
buffer. The most convenient 
place to put this is often 
immediately after the actual 
program, and we can do this by 
putting the label BUFFER (or any 
other suitable name) at the end 
of the listing. We can then use 
the program to store our 
generated data at the addresses 
starting at BUFFER. The only 
thing we must watch is to 
remember when we reserve 
memory for our program (usually 
using the RESPR command 
from SuperBasic), to make sure 
itis big enough to include both 
the program and the buffer we 
need. Otherwise we might find 
our QL has decided to use the 
buffer space for something else, 
with probable disastrous results. 


Block copy 


To fill such a buffer with data, 
we can use a “post 
incrementing" instruction to 


su 


o 


LISTING 3 


100 REMark Sinclair @L World HEX LOADER v 3 


110 REMark by Marcus Jeffery & Simon N Goodwin 


120 : 


130 CLS: RESTORE =:READ space: start=RESPR (space) 
140 PRINT "Loading Hex...":HEX_LOAD start 
150 INPUT "Save to file..."3;*% 
160 SBYTES f%,start,byte:STOP 


170 =: 


180 DEFine FuNction DECIMAL (x) 
190 RETurn CODE (h$ (x) )-498-7* (h(x) >"9") 
200 END DEFine DECIMAL 


210 : 


220 DEFine PROCedure HEX_LOAD(start) 
230 byte=0: checksum=0 
240 REPeat load_hex_digits 


250 
260 
270 
280 
290 
300 
310 
320 
330 
340 
350 
360 
370 
380 
390 


READ h¢ 


sToP 
END IF 


END IF 


END FOR b 


IF h$="#"sEXIT load_hex_digits 
IF LEN(h#) MOD 2 
PRINT “Odd number of hex digits in: 


FOR b=1 TO LEN(h$) STEP 2 
hb=DECIMAL (b) : 1b=DECIMAL (b+1) 
IF hb<O OR hb>1is OR 1b<O OR 1b>15 
PRINT "Illegal hex digit ins 


POKE start+byte,ié*hbtlb 
checksum=checksum+1i16*#hb+1b 
byte=bytetl 


400 END REPeat load_hex_digits 
405 PRINT checksum: STOP 


410 READ check 


420 IF check<>checksum 


430 
440 END IF 


450 PRINT "Checksum correct. Data entered at: 


PRINT "Checksum incorrect. 


460 END DEFine HEX_LOAD 


Recheck data. 


"she 


"sh:STOP 


":STOP 


"sstart 


REMark Space requirements for the machine code 


DATA 42 


DATA "SO3C8000": 
DATA "207000020000": 
DATA "“43FA001E"s 


REMark 
REMark 
REMark 


DATA "60000010": REMark 


DATA "3O3C8000": 
DATA "227600020000": 
DATA "41FA000C": 


DATA "12D8": 


REMark 


REMark 
REMark 
REMark 

- LOOP 


DATA "SICSFFFC":REMark 
DATA "7000": REMark 
DATA "4E75":REMark 


DATA "*", "2905" 


advance from one address to 
the next, in much the same way 
as we did in the previous part of 
this series. However, at that time 
we only did this to the 
destination address, which 
meant we copied the same data 
into all the bytes. But this type of 
instruction can be used to 
increment both the source and 
destination, and so copy a 
whole block of memory into 
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another block. Let us see how 
this works, 

Suppose address register AO 
contains $20000, which, you 
may recall, is the first address of 
the screen ram. Next, suppose 
register A1 contains the first 
address of our buffer. The 
instruction 


MOVE.B (A0)+(A1)+ 


means “take the contents of 
the address $20000 and copy it 
into the first address of the 
buffer, and then increment both 


#80000, DO 
#$20000,A0 
BUFFER, Ai 
Loop 
#$80000,D0 
#$20000,A1 
BUFFER, AO 
(AO) +, (A1) + 
Do, LOUP 
#$0,DO 


addresses”. The next time we 
use the same command it will 
mean “take the contents of 
address $20001 and copy it into 
the second address of the 
buffer, then increment both 
addresses’. Clearly, by putting 
this instruction into a suitable 
loop, we can copy the entire 
screen ram into our buffer as a 
temporary store, The DBRA 
instruction used last time will do 
fine for this if we make register 
DO contain $8000 to act as a 
loop counter. 

But we can do more than this. 


Suppose at some later time our 
screen has become altered, 
either by clearing it, or otherwise 
corrupting it. If we now make 
register AO contain the first 
address of the buffer, and 
register A1 contain the first 
address of the screen ram, we 
can use the same loop to copy 
the-contents of the buffer back 
to the screen ram, thereby 
restoring the screen to its former 
glory. Listing one shows how 
this is done. Much of it is very 
similar to the listing in part two, 
so if you understood that, then 
this should give you few 
problems. 

The first line puts $8000 (the 
size of the screen ram) into 
register DO to act as a loop 
counter. The second line puts 
$20000 (the start of the screen 
ram) into register AO. The third 
line uses the new LEA 
instruction to put the address of 
the buffer into register A1. Note 
that the label BUFFER is a the 
end of the listing, so the first 
address of the buffer will come 
after the last address of the 
program. 


Branch always 


Next comes another new 
instruction BRA which simply 
stands for “branch always”. It 
means exactly that - whatever 
happened before, the next step 
is to branch to the address 
given by the label in the 
operand, LOOP in this case. This 
loop is the one which copies 
the data from screen to buffer, 
and should need no further 
explanation. What does need 
explaining is why the loop is not 
the very next bit of code, so 
removing the need for the BRA 
instruction. 

The reason is that the loop is 
to be used not only to copy the 
screen to buffer but also to copy 
the buffer back to the screen. 
This requires the registers to be 
set up in a slightly different way, 
and so the next three 
instructions (5th, 6th and 7th) 
give the alternative starting point 
used for restoring the screen. 
The three instructions are 
exactly the same as the first 
three except that registers AO 
and AO have been swapped 
over, 

When the program is 
assembled, we need a 
SuperBasic program to CALL 
the code to see how it works, 
Listing two is a simple 
example. It loads the code, 
produces a distinctive pattern on 
the screen, saves it in the buffer, 


-clears the screen, and finally 


restores the pattern from the 
buffer. Note the large parameter 
in the RESPR command. This is 
because we need to reserve 
enough ram for the code (which 
is only a few bytes long), plus 
the whole screen ram, which is 
32 kilobytes long! 


Disassembly 


There is an extra complication 
here which did not occur in the 
previous SuperBasic programs. 
We have two starting points in 
our code, one for copying the 
screen to the buffer, and one for 
copying the 


There is one possible problem 
with some assemblers, though. 
There is an alternative version of 
the BRA instruction, BRAS. This 
stands for “short branch always’, 
and can be used when the 
address we are branching to is 
close by, which it is in our 
program. This alternative is 
actually preferable, because it 
results in a shorter program 
which runs faster (though not 
noticeably in this program). | 
have not used it because it is an 
extra complication | would rather 
leave to later. 

The problem is that some 
assemblers will automatically 
use BRAS if possible, even if 
you actually used BRA in the 
program, in 


buffer to the +The only way to do this is o;4er to make 
geyser) fo use a disassembler, =e program 
Copying the , soe better than the 
screento Whichisa program todo one you 

the buffer is the opposite to the actually wrote. 
no problem ‘ If this 
because we assembler x it converts happens, you 
start from machine code into will need to 
the first a = alter line 310 
address of something like the in Listing two 
pr ren original assembler to 

is, of course, listing, together with the = cai 7+14 
the address memory addresses 

used for the ry As in the 
LBYTES previous 


command which was obtained 
by the RESPR command. But 
how do we know that if the 
program loads at address z, 
then the address to CALL to 
copy the buffer back to the 
screen is (z + 18)? 

The only way to do this is to 
use a disassembler, which is a 
program to do the opposite to 
the assembler - it converts 
machine code into something 
like the original assembler 
listing, together with the memory 
addresses. By looking at a 
disassembler output | could see 
that the 


MOVE.W #$8000,D0 


instruction was $12 from the 
start of the program, and, 
converting that into normal 
decimal notation, gives us 18. 

If you do not have a 
disassembler, then you really 
should get one if you seriously 
want to do machine code 
programming. Quite apart from 
the use | have made of it here, it 
is a quite invaluable tool for 
debugging your program to find 
the simple little mistakes every 
programmer makes all the time. 

However, provided you have 
copied Listing one correctly, and 
successfully assembled it, the 
CALL address | have used in 
Listing two should be correct. 


articles, | have assumed that the 
machine code is in a file 
LISTING1_code in flp1_. You 
may need to alter this to suit 
your circumstances. Also, for 
benefit of those without an 
assembler, | have Marcus and 
Simon's hex loader set up to 
generate the machine code. 

Once you have got the 
machine code to work, there are 
one or two little experiments you 
can try. 


Word at a time 


First, we don't have to transfer 
data a byte at a time. We can do 
ita word at a time, or a long 
word at a time. To transfer a 
word at a time simply requires 
the LOOP line to be altered to 


MOVE.W (A0)+(A1)+ 


Because the data is now 
moving two bytes at a time, it 
only requires half as many step, 
so the lines setting the loop 
counter must be altered to 

MOVEQ $#4000, DO 


This should make the code 
run faster, although it runs so 
fast already, you will be hard put 
to notice the difference, unless 
you repeat it over and over 
again in rapid succession. If you 
have understood this alteration, 
you should be able to work out 
for yourself how to alter the code 
to transfer the data a long word 
at a time and make it faster still. 

Another interesting variation to 
the program is this: instead of 
copying the whole screen to a 
buffer, we could copy one part of 
the screen to another part of the 
screen, provided the parts of the 
screen consist of consecutive 
screen bytes. For example, to 
copy the top half of the screen 
to the bottom half and vice 
versa, we need these alterations. 

Instead of the LEA instructions 
for loading the buffer address, 
we can use 


MOVEAL #$24000,A0 


which loads the address half 
way down the screen. Since we 
are only moving half a screen at 
a time the loop counter line 
must be changed to 


MOVEQ #$4000,D0 


Since we are not using a 
buffer, we can do away with the 
BUFFER label in the code, and 
when we load the machine 
code we can make do with 32K 
less memory. 

If you get this to work, you 
should then be able to write 
versions to transfer parts of the 
screen either a word or a long 
word at a time. 


Any part 


Clearly, with a few simple 
changes, this routine can be 
used to copy any part of the 
memory (ram or rom) to any 
other part of the ram. (However, 
we must be careful about where 
in ram we put it, or Qdos may 
object, and crash.) | said at the 
outset that | would make all the 
examples in this series do 
something on the screen, to 
make it obvious what had been 
done, which is why | have used 
the routine in this particular way. 

| hope you will agree that 
what we have here is a simple 
routine that really can be used 
to improve our SuperBasic 
programs, the promised 
Quantum Leap. 
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SuperBasic 


In Action 


Simon Goodwin explains how most printers can be persuaded 


fo print QL screens in colour. 
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project uses the powerful RECOL 
command to separate the 
colours on a QL screen, so that it 
can be printed in successive 
passes with different coloured 
ribbons or ink cartridges. The 
technique works with most 
printers that can only print one 
colour at a time, including cheap 
matrix printers. 

The only types not supported 
are thermal printers like the Serial 
8056, which cannot be 
persuaded to bum their paper to 
any colour other than the default, 
usually black, and daisywheels, 
which do not support graphics 
printing. 

You do not need a special 
colour driver, like Psion’s JX80 
routine for colour Epsons. You 
can use the normal GPRINT_PRT 
from your Easel cartridge, or 
commercial alternatives like 
TASCOPY or ULTRAPRINT, which 
are faster and can print the 
whole area of the screen. 


Ink-change 


The only catch in this method, 
compared with true colour 
printing, is that you need to re- 
position the paper and change 
the ink for each component 
colour. I's a reasonable economy 
if most of your printing is 
monochrome and you only need 
colour images occasionally. 

| can't afford a full-colour 
printer, but | can generate colour 
prints with the Deskjet 500, using 
a succession of different 
coloured ink cartridges. These 
are easier and cleaner to change 
than coloured printing ribbons, 
and the Deskjet's sheet feeder 
means that successive colours 
are correctly aligned. 


UW. 


The examples use the 
HPDUMP. command introduced 
in DIY Toolkit last month, but 
could just as well use 
GPRINT_PRT. To run this from 
SuperBasic you need to load it 
into memory allocated with 
RESPR or ALCHP, and CALL the 
start each time you want to send 
a dump to the printer. 

These commands allocate 
memory, load the GPRINT file 
from floppy disk 1, and print the 
current screen: 


X=RESPR(640) 
LBYTES FLP1_GPRINT_PRT.X 
CALL X 


The size of the GPRINT file 
may vary depending on your 
printer and version of the Psion 
software, but 640 bytes is 
enough for all the versions | have 
encountered. 

Toolkit functions like ALCHP, 
RESERVE and ALLOCATION let 
you deallocate the memory when 
the printing is done, whereas 
RESPR memory” remains 
allocated till you reset the 
computer. Use RECHP X to 
deallocate ALCHP space, 
DISCARD X for DIY Toolkit, and 
DEALLOCATE X for DIY Toolkit 

GPRINT_PRT scans are 480 
pixels wide, wide enough for 
EASEL displays and TV screens 
but 32 pixels less than the full 
Mode4 screen. Later Epson 
dump routines like SIDEWINDER 
and TASCOPY avoid this 
limitation of 80-column printers 
by printing the screen down 
rather than across the paper. 

Psion's GPRINT_PRT was only 
designed for nine-pin printers, but 
Dilwyn Jones's Trans 24 utility 
can translate its output to suit 
more modern 24 pin models. 
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Alternatively Dilwyn's /mage 
Processor can drive most 
modem printers directly. 


Saving Screens 

Psion’s Ease/ can save 
screens to a file instead of the 
printer, adding the extension 
_PIC to the device and file name 
you supply. If you have access to 
SuperBasic you can save the QL 
screen image at any time with 
this command: 


SAVE 
FLP1_MY_SCREEN,131072,32 
768 


The numbers give the start 
and size of the screen memory 
area. Use 163840 instead of 
131072 if you want to save 
Minerva’s second screen. 

lf SuperBasic is busy, build 
these commands into a 
compiled task triggered by a key- 
press, or invest in Dilwyn Jones's 
multi-tasking Screen Snatcher, 
designed for just this purpose. 


Mode4 colour 

To print Mode4 screens in full 
colour on white paper, you need 
red and green ink cartridges as 
well as the usual black one. Start 
with the red cartridge, and set a 
full-screen window with WINDOW 
512,256,0,0 . Load the Mode4 
screen, with LBYTES, then type: 


RECOL 0,0,7,7,0,0,00 : 
HPDUMP. 


The RECOL replaces all the 
red in the screen with white, and 
then prints that, with brightness 
inverted so that only the red part 
of the picture is inked. By default 
HPDUMP generates an ‘reversed! 
monochrome image, with black 
on white print for white on black 
displays. Replace Os with 7s, and 
vice versa, in the RECOL 


command if your dump routine 
does not reverse the colours. The 
next pass uses the Green ink 
cartridge. Move the piece of 
paper from the top to the bottom 
tray, so it can be overprinted with 
green ink. Re-load the original 
screen before you issue the 
RECOL command, as the green 
information will have been 
eliminated by the red print pass. 
These commands add the 
Green part of the picture: 


RECOL 0,0,0,0,7,7,00 : 
HPDUMP 


The final stage, in Mode4, is to 
add the black: 


RECOL 7,7,0,0,0,0,0,0 : 
HPDUMP 


Coloured ink cartridges are 
available from many suppliers, 
and it is cheap - if a little fiddly - 
to re-fill used cartridges with fresh 
ink. You can usually find 
suppliers at an All Formats Fair; | 
obtain my supplies from 
Mechanical Services, 11 
Elisabeth Road, Sutton Coldfield, 
West Midlands B73 5AR. They 
can also supply special inkjet 
paper which copes well with 
overprinting, and coloured 
ribbons for matrix printers - call 
021 354 3299 to check if your 
printer is Supported. 


Mode8 pictures can be 
processed in a similar way, but 
there is no need to use seven 
different ink colours, As long as 
you print the lightest colours first, 
you can generate all the QL 
colours by successive 
overprinting in yellow, cyan and 
magenta. 

You get better results if black 
parts of the picture are printed 
with a black cartridge, rather than 
a murky mixture of the three 
secondary colours. This is the 
technique used to print QL 
World's coloured covers. 

In theory the Mode4 dump 
could mix red and green to get 
black, but this is hardly 
worthwhile as it spoils the result, 
and most printers come with a 
black cartridge or ribbon as 
standard. 

Conversion from the QL 
screen's RGB (Red Green Blue) 
colours to printer-friendly CYMK 
(Cyan, Yellow, Magenta and 
blacK) involves a_ similar 
sequence of RECOL statements 
and dump commands. 

Once again we recolour 
required parts of the picture to 
show where the ink should go, 


but this is complicated because 
Mode8 display memory uses a 
different internal code for white, 
and the separations must be 
converted to their Mode4 
equivalent before HPDUMP is 
called. 

One in every four bits of a 

Mode8 screen is reserved for 
flash’ information, so white areas 
use 12 set bits in Modes, rather 
than all 16 in Moded. If we print 
this with a Mode4 dump routine 
like HPDUMP or 
TASCOPY_MON, there will be 
stripes across areas that should 
be all the same colour. 
This is no problem with a 
ode8 routine like TASCOPY_TV, 
which ignores the flash bits, but it 
needs attention if you want to 
use GPRINT_PRT or HPDUMP. 

The trick is to recolour the 
reuired part of each separation 
into magenta on a Mode8& 
screen, then save and re-load the 
image as Mode4, where it will 
appear as red, rather like a Qdos 
cursor does when you change 
mode. Once in Mode4 we can 
convert the red to white, either 
with RECOL or faster with the 
SET_GREEN -1 command from 
DIY Toolkits Windows volume W. 

The listing takes a 32K screen 
file and converts it into four 
separate screens, sent to the 


ARGHIWVE YOUR @QlLL 


printer in sequence. It uses a 
temporary file to move the image 
from Modes to Mode4, and 
loads the original screen four 
times, so delays are minimised if 
you keep all the files on ram disk. 
Edit the name in A$ to suit your 
original file and change the 
temporary name in BS if you like. 

The lightest colour, yellow, is 
printed first and black is added 
last, as this gives the best 
resolution. The program waits for 
you to press Enter to signal that 
you have changed the ink before 
each pass. 

When coloured inks are 
printed on top of one another 
only the common component is 
reflected, so green uses cyan on 
top of yellow, and blue is made 
from cyan and magenta. If 
magenta and yellow inks are 
mixed you get red. The other 
Mode8 colours are white - the 
paper colour - black, froma 
separate ink cartridge, and the 


secondary ink colours 
themselves. 
Other models 


| have not tried Mode8 colour 
printing on a dot-matrix printer 
but my friend Andy Wright reports 
success with four coloured 
ribbons and an old Epson RX-80 


printer. Ribbon changes can get messy, and you need some way to 
ensure accurate alignment. Use a sheet feeder, or an alignment mark 
on the printer body, but make sure that the paper is tensioned the 


same way before each pass. 


Laser printers can use coloured toner, equivalent to coloured ink, but 
such toner cartridges are relatively expensive. | don’t know anyone who 
uses multiple laser passes to print in full colour, but the principle 
should be the same as for other types of printer. Whatever you use, let 


us know how you get on. 


REMark MODE 8 COLOUR SEPARATIONS 
REMark V2, for any mono QL screen-dump 
REMark Copyright 1993 Simon N Goodwin 


aS="ram1_. 
bS="ram1_' 
screen=131072 


Arbitrary_Screen" 
Temp" 
:REMark 163840 for Minerva #2 


fullsize=32768 


MODE 8 


OPEN #3,"SCR_512x256a0x0" 


INPUT #0; 


SEPARATE 


INPUT #0; 


SEPARATE 


INPUT #0; 


SEPARATE 


INPUT #0; 


SEPARATE 
CLS #3 
CLOSE #3 


"Press ENTER for 
0,0,3,0,3,0,3,0 
"Press ENTER for 
073),0;0',3,3'70,0 
"Press ENTER for 
0,3;,3,3,0,0,0,0 
"Press ENTER for 
3,0,0,0,0,0,0,0 


YELLOW pass ";c$ 
:REMark Yellow 
CYAN pass ";c$ 
:REMark Cyan 
MAGENTA pass ";c$ 
:REMark Magenta 
BLACK pass ";c$ 
:REMark Black 


DEFine PROCedure SEPARATE(a,b,c,d,e,f,g,h) 


MODE 8 


LBYTES a$,screen 
RECOL #3,a,b,c,d,e,f,g,h 
SBYTES b$,screen,fullsize 


MODE 4 


LBYTES b$,screen 


DELETE b$ 


REMark SET_GREEN #3,-1 or 

RECOL #3,0,0,7,0,0,0,0,0 

HPDUMP :REMark or TASCOPY_MON etc. 
END DEFine SEPARATE 


DEFine PROCedure S 
SAVE SEPARATOR_BAS 
END DEFine S 


GOLLEGTIOIN 


Worl 


Now you can keep your Sinclair QL 
magazines safe and clean. No 
more dog-eared covers or missing 
copies .. . You can protect your 
magazines in this high sth , 
specially-created binder. This Sinclair 
QL World binder will comfortably hold 
a complete year’s issues of your 
favourite Sinclair magazine. It is a high 


quality product, British-made and | 
comes with full binding instructions. It is 
manufactured in a rich, deep blue with 


genuine gold blocked lettering. 
Enhance your Sinclair QL World 
Magazine collection now for only 
£6.95 (inc.P&P!) Send for one today! 
The QL World binders also make an 


ideal gift for other Sinclair users too! 


1 TO: QL WORLD, THE BLUE BARN, WOOTTON, WOODSTOCK, OXON. OX7 1HA: a4 | 
I Please send me L_] QL World binders — | enclose £6.95 for each binder including VAT. postage & packing. l 
I Readers outside the UK and Eire please add £1.95 for surface overseas mail. oe I 
| Please make cheques payable to ARCWID LTD. | 
| ACCESSL_]VISAL_Jaccount: | | | | | Expiry dates... | 
I I 
LC en MOK) BIE J 
Le ee A J 


Postcode 


AEN INOS score ohh Ree Re eee 


ss 
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Sincian GR Won 45) 


FFFE LLTILLT's 


UK 
£FA3.40 
(12 MONTHS) 


EUROPE 
=-32.90 
(12MONTHS) 


REST OF 


WORLD 
£40.90 
(12 MONTHS) 


PLEASE SEND YOUR 
SUBSCRIPTION FORM TO 
SINCLAIR QL WORLD, 
THE BLUE BARN, TEW 
LANE, WOOTTON, 
WOODSTOCK, OXON. 
OX71HA. 

TEL:0993 811181 

FAX:0993 811481 


SUBSCRIBE TO 
SINCLAIR OL WORLD 
AT LAST YEARS 
PRICES AND SAVE 


| WISH TO SUBSCRIBE TO 
SINCLAIR QL WORLD 

WE HAVE HAD TO RAISE THE 
COVER PRICE OF QLWORLD 
BUT WILL BE HOLDING LAST 
YEARS SUBSCRIPTION PRICE 
FOR THE IMMEDIATE FUTURE 
ONLY. 


Existing subscribers will not be affected. 


Ceoeeeeeeeeeeeeeseeeeeeeeeeees 
PLEASE DEBIT MY CREDIT CARD ACCESS/VISA 

ee PAIRED TTI nics saisge sea eek a aedignd gtan gate ones sumac evan ves sean eens ead 
EXPIRY DATE 

PLEASE SEND ME A 12 MONTH SUBSCRIPTION TO SINCLAIR 
QL WORLD, 


ee ee ee eee ee eee eee eee eee eee eee ee ee eee eee ee eee eee ee ee 


TELE RINE PUT ABE Axacus fe wanveccatnnaneaiuntnnkennedbhega awaits 
US TE on i cceigasiscenssan pen eda nig assure ia ua iocae aida ben waliennrsiuapmduiae 


SINCLAIR QL + twin floppy 
drives, 256k memory, separate 
keyboard, many games £125 
0491 681821 


QL JM EXPANDED, 
SUPER-Q board 512k, 102-key 
keyboard, NEC 3.5" drive, Philips 
monitor, Epson RX-80 printer, 
Psion V2.35, QRAM, QUIMI, 
Manual, DL World Mags, £200 
ono, Tel:0952 676668 evening 


QL unexpanded AH 
version PSU Psion software 
manual etc. Any offers 
Miracle Systems QL modem 
£20. Phone: John 0689 
855444 


JS QL, Metal case, PC 
keyboard and |/face, twin 3- 
1/2” d/drives and OPD 
m/drives, some software, new 
colour monitor £250 ono. 
Also Tandata modem 3, 
CQVI Digitiser and more. Tel: 
(Derby) 0332 677746 


QL unexpanded JM 
version, shinwa CPA 80Q 
printer, joystick, Software 


Please send coupon to: Advertising Department Sinclair/QL World, The Blue 
Barn, Wootton, Woodstock, Oxon, OX7 1HA. Please place this Classified 
Advertisement in the next issue of Sincair/QL world, 


including Psion suite, Eye-Q 
and Games, 40 MDV's, 
Manuals etc, £150 Tel:0256 
764006 evenings only 


QL Minerva Rom,Trump 
Card 3-1/2" D/D,Miracle 
centronics (x2) Tandata 
modem serial printer, 6 years 
QLWorld, Quanta mags, 
books, software, b/w 
television extra MDV. 
Sensible offers please. Tel: 
0977 515428 


WITH REGRET, Offers for 
complete QL System. Two 
Computers 14" colour 
monitor, double disk drive, 
ice, Original software plus 
more. Books, Manuals. Psion 
organiser and printer. Phone 
for details 0257 265700 


COMPLETE OUTFIT QL 
640k js. Twuin Cumana 5.25" 
disc drives. 14" colour 
monitor, Tandata modems. 
Manneshan MTS. Printer 
lightening S.E. Backup QL 
manuals etc. All VGWO offers 
Cliff 0934 812640 


DAYTIME: FEL PTOI Be cecal nado aesaerensbriondeieninisiansice 


fe 


MICRO ADS 


Professional pool!ster 


REVOLUTIONARY 


NEW SYSTEM 


COMBINES 
Sound logic with A./. to win £ hundreds £ 
Analysis of Bookies Factors for matches 
Common sense improves chances of Mega-Win 
UNIQUE ENTRY SYSTEM 
Takes only a few minutes each week 
Over 300 teams in data-bank. 
Minor league teams automatically added. 
Prior to PC release @ £99.00 
To QL users offered at SPECIAL PRICE £49 
THIS MONTH 
MONEY BACK GUARANTEE - Make a profit in your first full season or 
your money back. 
256K ROM minimum. Discs Only. State 3.5 or 5.25 
CHEQUE OR P.O. TO S.CANTON, OCEAN COMPUTER SERVICES, PO 
BOX 68, NORTH DO. Manchester M8 6NJ 
Tel. 061 740 9002 


| enclose a cheque/P.O. to the 
value of £17.65 (inc. VAT) fora 
lineage advertisement of no 
more than 30 words. Please 
make cheques payable to: 
Arcwind Ltd. 


GailISsv1D> 


DILWYN JONES COMPUTING 


41 BRO EMRYS, TAL-Y-BONT, BANGOR, 


GWYNEDD, LL57 3YT, GREAT BRITAIN 
TELEPHONE: (0248) 354023 


L SOFTWARE 


A SELECTION FROM OUR RANGE OF NEARLY 100 PRODUCTS FOR THE QL, NO 
ROOM TO ADVERTISE THEM ALL HERE, SO PLEASE ASK FOR OUR 
CATALOGUE (PHONE FOR A COPY OR SEND A LETTER WITH YOUR ADDRESS). 


EASYPTR III part £40.50 

Simplified pointer environment programming. 
Part I consists of sprite editor, menu editor and 
superbasic extensions to use in your own 
programs. Applications created using Easyptr III 
can be compiled with QLiberator. Requires 
expanded memory, available on disk only. 


EASYPTR III part 2 £20.00 

Consists of appendix manager and enhanced 
toolkit FD control of menus etc in your programs. 
EAS III part £20.00 

Consists of Easysource and C library routines etc. 


QLIBERATOR £50.00 

Superb superbasic compiler, compiles virtually all 
of basic plus most toolkit commands, etc. 
Produce faster multitasking code from your basic 
programs. Compile resident extensions, use 
overlays etc, with the latest V3.36. Can be mouse 
controlled. Expanded memory required. 


BUDGET QLIBERATOR £25.00 

Excellent value, virtually all of superbasic but 
without some of the additional facilities of the full 
version. Not mouse controlled. Works on 
unexpanded QL too. 


DJTOOLKIT £10.00 
Compact toolkit of BASIC extensions, ideal for 
use with ALiberator. Really useful programming 
on can be pies e our 
compiled programs if you wish. At this price, a 
bargain! Suitable Jor unexpanded QL. 


LINEDESIGN £100.00 

Vector drawing package, uses outline fonts and 
clipart, move and resize text and graphics 
without loss of quality. Ideal for making posters, 
etc. Supplied with huge range of fonts and clipart 
on TEN disks! The more memory your system 
has, the better! Available on disk only, can be 
mouse controlled (including SERmouse). 


DATA DESIGN 3 £60.00 
Superb, fast pointer driven database with free 
form field structures, with the option of disk 
based for large files if required, or smaller files 
can be kept in memory for speed. You do not 
have to be able to program this version but if you 
add the API package, it can be programmed 
Jrom basic, C, or assembler. Expanded memory 
required, disk only. 
API for Data Design £20.00 

£39.95 


QPAC2 
Tony Tebby’s pee? Pointer environment 
package. in addition to the pointer environment 
files themselves, this includes tutorials, extensive 
manual, files menu, channels and jobs menus, 

pe eat) between jobs, hotkeys, etc. Mouse 
or keyboard controlled, a good introduction to 
paler environment, 256k ram minimum, disk 
only 


QPACI £19.95 

Ideal companion to QPAC2, consists of small 
accessory programs such as calculator, calendar, 
clocks, alarm clocks, typewriter, etc, All can be 
mouse controlled. Pointer environment files 
included. Can be used with or without QPAC2. 
Expanded memory required, disk only. 


QTYP2 £29.95 
Tony Tebby’s spelling checker program. Check 
spelling as you type OR check existing files 
retrospectively. User interface allows you to write 
programs which use the dictionary facilities. 
English, French and German dictionaries 
included! 


DISA £29.00 
Interactive pointer driven machine code 
disassembler. 256k ram min. Disk only. 


MEGATOOLKIT £25.00 
EPROM VERSION £40.00 
Large toolkit with over 200 BASIC extensions, 
suitable for use with QLiberator or Turbo. Many 
examples supplied, extensive manual. Suitable 
Jor unexpanded QL. 


DISCOVER £20.00 
The painless way to move files from QL to PC 
and vice versa, As simple as copying files between 
two disks. 256k ram min., disk only. 


MULTI DISCOVER £30.00 

In addition to Discover facilities, also contains 
CPM, Unix CP10, BBC micro and now Spectrum 
and SAM Coupe file transfer capability. 256k 
min. ram, disk only. 


TEXTIDY £15.00 
Assists Discover with conversion of text files by 
stripping out control codes etc. 256k ram min. 


CONVERT-PCX £10.00 
Used with Discover, allows transfer of bit mapped 
PC clipart graphics in PCX format (a common 
PC file orae. to QL screens or Page Designer 
pages. 256k ram, disk only. 


QL-PC-FILESERVER £24.50 
Link a PC and a QL via a serial port cable and 
use this software to enable the two to 
communicate - the QL can save its files on a 
PC's disk systems and print to the PC’s serial port 
using normal basic commands like COPY. Works 
on unexpanded QL. 


£25.00 
Simple to use banner maker which uses outline 
fonts for good quality large texts. Prints sideways 
across up to 4 sheets of paper. Simple to use, 
menu driven, on screen preview before printing, 
etc. Suits most Epson compatible printers. 


IMAGE PROCESSOR 2 £15.00 
Easy to use graphics ale featuring usual 
graphic facilities, pixel zoom editing, image 

i aaa mode conversion etc. 512k, disk 
only. 


SCREEN COMPRESSION £10.00 
Reduce the amount of storage required by 
graphics on disk or microdrive - supports several 
QL formats. 256k, disk only. 


SCREEN DAZZLER £15.00 
Unlike the usual screen savers, which simply turn 
off the display when the keyboard is not used for 
a while, his one can activate various graphical 
displays to provide an attractive means of 
preventing screen bum-in, more like the screen 
savers on other computers. If you have a 
compiler, you can even write Paige own savers by 
following the instructions in the manual. Pointer 
environment compatible. 


SCANNED CLIPART 1 £10.00 
NEWIA disk full of compressed scanned pictures 
(decompression program supplied of course) 
which. can be used in most QL programs (DTP, 
graphics, etc). Assorted collection, containing 
many pictures you may not find in other 
collections. Large number of pictures, a bargain 
at this price. 128k, disk only. > 


PRINTERMASTER £20.00 
Select printer control codes quickly and simply 
jrom a menu to set fonts, page lengths, etc. 
before printing from programs like Quill, etc. 
128k, diskimdv 


SERMOUSE £40.00 
Albin Hessler’s serial mouse driver system for the 
QL is now available from DJC complete with a 
QL style matching black mouse with 9 pin serial 
connector and UK style port adaptor lead. 
Version 3 driver software. Can now work with The 
Painter too. NB POSTAGE CHARGES BELOW 


MAGAZINES EX-CGH SERVICES 

Ask for a price list of back issues of QL Technical 
Review, QL Leisure Review and QL Adventurer’s 
Forum (all available at time of writing). 


SQUIDOY ROUND THE WORLD £12.50 
An arcade game, ideal for the young at heart! 


128k 
5-GAMES PACK £12.50 


5 ‘thinking’ games in one bargain pack, 128k 


SUPPLIES 
FLOPPY DISKS 
DSHD DISKS 
MICRODRIVES 
DISK LABELS 
On printer roll 
ADDRESS LABELS 
MDV LABELS 
MOUSE MATS 
Disk box dividers 
in stock once more! 


TERMS: Discounts - buy 2 programs, claim 5% off each, buy 3 or more, claim 10% off each program. Offer applies to software only. POSTAGE - Software is sent post free to UK addresses. 
Overseas please add £1.00 per program for postage (maximum £3.00). Floppy disks and serial mouse - add postage of £2.50. Labels|mouse mats - add postage of £0.50 peritem if only buying 
these. PAYMENT - in UK currency (pounds sterling) only please. Payment by cheque, Eurocheque, Postal Order, cash (send by registered pos, or by credit card 
(Visa/Mastercard/Eurocard/Connect). In case of difficulty contact us first to arrange a payment method if none of these is possible for you. Please make cheques, etc payable to DILWYN JONES 
COMPUTING (not to any other name or abbreviation please, our bank prefers it that way). 


